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

Uno

التكامل

معرّف النموذج uno
# 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/uno?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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.05 $⁩ 50 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
ByteDance تحرير الصور #image-to-image

توليد صور متعددة المراجع يمزج عدة صور إدخال مع مطالبة نصية

ByteDance · صورة

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

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

إنشاء طلب

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

•مطلوب

الموجّه الذي يوجّه توليد الصورة.

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

عناوين URL للصور المستخدمة أثناء توليد الصورة.

image_size الافتراضي square_hd

أبعاد صورة المخرج، تُختار من إعدادات مسبقة أو تُحدّد بعرض وارتفاع مخصّصين. يجب أن تكون الأبعاد المخصّصة كلاهما قابلتين للقسمة على 8.

num_images الافتراضي 1

عدد الصور المطلوب توليده.

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

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

الافتراضي 28

عدد خطوات الاستدلال المطلوب تنفيذها.

الافتراضي 3.5

قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).

بذرة التوليد: تختار none قيمة عشوائيًا، بينما تتيح القيمة المقدمة توليدًا قابلًا لإعادة الإنتاج.

POST /run/uno?wait=20 عرض السعر → ⁨‏0.05 $⁩
# 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/uno?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

حول Uno

يولّد صورًا جديدة من موجّه مع صورة مرجعية واحدة أو أكثر في `input_image_urls`. تقبل `image_size` إعدادات مسبقة من المربع إلى 16:9 العمودي والأفقي، وينتج `num_images` من 1 إلى 4 نتائج. يتراوح `num_inference_steps` من 1 إلى 50 و`guidance_scale` من 1 إلى 20. المخرج JPEG أو PNG، مع بذرة لإعادة الإنتاج.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
input_image_urlsمطلوب
النوعurl[] · image
عناوين URL للصور المستخدمة أثناء توليد الصورة.
image_sizeاختياري
النوعobject
الافتراضيsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد صورة المخرج، تُختار من إعدادات مسبقة أو تُحدّد بعرض وارتفاع مخصّصين. يجب أن تكون الأبعاد المخصّصة كلاهما قابلتين للقسمة على 8.
promptمطلوب
النوعstring
الموجّه الذي يوجّه توليد الصورة.
seedاختياري
النوعinteger | null
بذرة التوليد: تختار none قيمة عشوائيًا، بينما تتيح القيمة المقدمة توليدًا قابلًا لإعادة الإنتاج.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليده.
num_inference_stepsاختياري
النوعinteger
الافتراضي28
1 – 50
عدد خطوات الاستدلال المطلوب تنفيذها.
guidance_scaleاختياري
النوعnumber
الافتراضي3.5
1 – 20
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق ملف الصورة الناتجة.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
مفتاح فحص الأمان الذي يتطلب إعداد إيقافه تفويض الحساب. من دون هذا التفويض، يُفحص كل طلب بغض النظر عن الإعداد؛ وتفعّل true أداة الفحص.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "uno",
  "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": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "The figurine is in the crystal ball"
  },
  "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}عناوين URL للصور المولّدة.
timings
object
seed
integerبذرة توليد الصورة، بما في ذلك القيمة المختارة عشوائيًا إذا لم يتضمن المدخل بذرة؛ وإلا تكرر القيمة المقدمة.
has_nsfw_concepts
array of booleanيشير إلى ما إذا كانت مفاهيم NSFW تظهر في الصور المُولّدة.
prompt
stringالموجّه المقدم لتوليد الصور.

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