تخطّي إلى المحتوى

Hidream O1 Image · Edit

التكامل

معرّف النموذج hidream-o1-image/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hidream-o1-image/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.04 $⁩ 40 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
HiDream تحرير الصور مدخلات مرجعية

تحرير الصور المرجعية وتخصيص العناصر بجودة كاملة، حتى نحو 2048x2048 و50 خطوة

HiDream · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

تعليمات نصية لتوليد الصور أو تحريرها، أو لتخصيص موجّه بالموضوع.

•مطلوب reference_image_urls
أفلت ملفًا، أو

الصور المقدَّمة كمراجع للتحرير أو للتخصيص الموجّه بالموضوع.

image_size الافتراضي {"height":2048,"width...

اختيار أبعاد الصورة؛ بالنسبة إلى المخرجات المستندة إلى صور مرجعية، يطابق هذا الطلب أقرب دقة يدعمها النموذج، بحد أقصى تقريبي يبلغ 2048 × 2048 بكسل.

num_images الافتراضي 1

عدد الصور المطلوب إنتاجها.

متقدم output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · keep_original_aspect
output_format الافتراضي png

تنسيق ملف الصورة الناتجة.

الافتراضي 50

عدد خطوات إزالة التشويش المطلوب تنفيذها.

الافتراضي 5

مقياس التوجيه الخالي من المصنّف؛ افتراضيًا 5.0 للنموذج الكامل.

بذرة عشوائية تجعل التوليد قابلاً لإعادة الإنتاج.

POST /run/hidream-o1-image/edit?wait=20 عرض السعر → ⁨‏0.04 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hidream-o1-image/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Hidream O1 Image · Edit

يحرر الصور أو ينشئ نتائج موجهة بالعناصر من صورة مرجعية واحدة أو أكثر (`reference_image_urls`) بالإضافة إلى مطالبة نصية `prompt`. يستخدم حجم الناتج إعدادات مسبقة أو حجمًا مخصصًا، حتى نحو 2048x2048. يستخدم افتراضيًا 50 خطوة لإزالة الضوضاء مع توجيه 5، ويمكنه إرجاع من 1 إلى 4 صور بصيغة PNG أو JPEG أو WebP. يحافظ `keep_original_aspect` على نسبة الأبعاد عند تقديم مرجع واحد.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
تعليمات نصية لتوليد الصور أو تحريرها، أو لتخصيص موجّه بالموضوع.
reference_image_urlsمطلوب images
النوعurl[] · image
الصور المقدَّمة كمراجع للتحرير أو للتخصيص الموجّه بالموضوع.
image_sizeاختياري
النوعobject
الافتراضي{"height":2048,"width":2048}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
اختيار أبعاد الصورة؛ بالنسبة إلى المخرجات المستندة إلى صور مرجعية، يطابق هذا الطلب أقرب دقة يدعمها النموذج، بحد أقصى تقريبي يبلغ 2048 × 2048 بكسل.
num_inference_stepsاختياري
النوعinteger
الافتراضي50
1 – 50
عدد خطوات إزالة التشويش المطلوب تنفيذها.
guidance_scaleاختياري
النوعnumber
الافتراضي5
0 – 20
مقياس التوجيه الخالي من المصنّف؛ افتراضيًا 5.0 للنموذج الكامل.
seedاختياري
النوعinteger | null
بذرة عشوائية تجعل التوليد قابلاً لإعادة الإنتاج.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب إنتاجها.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpngwebp
تنسيق ملف الصورة الناتجة.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يحدد ما إذا كانت الصور المُولَّدة تخضع لفحص السلامة.
keep_original_aspectاختياري
النوعboolean
الافتراضيfalse
الحفاظ على نسبة العرض إلى الارتفاع للتوليد بمرجع واحد: يطابق المخرج نسب المرجع فقط عند تقديم صورة واحدة بالضبط.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hidream-o1-image/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, content_type, file_name, file_size, width, height}الصور الناتجة عن التوليد.
seed
integerقيمة البذرة المطبّقة أثناء التوليد.
has_nsfw_concepts
array of booleanحالة علامة فاحص السلامة لكل صورة مُولَّدة.
prompt
stringالموجّه المستخدم لتوليد المخرج.
timings
objectقياسات توقيت التوليد.

مزيد من النماذج: تحرير الصور

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/hidream-o1-image/edit.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt