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

Uso

التكامل

معرّف النموذج uso
# 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/uso?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"
    ]
  }'

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

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

توليد صور قائم على النمط والموضوع من صورة محتوى مع صورة نمط واحدة أو صورتين

ByteDance · صورة

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

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

إنشاء طلب

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

الافتراضي

نص موجّه التوليد؛ اتركه فارغًا لتنفيذ نقل النمط فقط.

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

قائمة عناوين URL للصور بهذا الترتيب: [content_image, style_image, extra_style_image].

image_size الافتراضي square_hd

أبعاد الصورة المُولّدة.

num_images الافتراضي 1

عدد الصور المولدة بالتزامن.

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

المحتوى غير المرغوب في الصورة المراد استبعاده، بما في ذلك العناصر والأنماط والآثار.

output_format الافتراضي png

تنسيق صورة المخرج: يحافظ PNG على الشفافية، بينما ينتج JPEG ملفات أصغر.

الافتراضي 28

عدد تكرارات إزالة التشويش، إذ يوازن بين مدة توليد أطول وجودة أفضل محتملة مع زيادة العدد.

الافتراضي 4

يتحكم في مدى الالتزام بالموجّه: زد هذه القيمة لجعل النتيجة تتبع الموجّه بدرجة أكبر.

قيمة seed تتحكم في عشوائية التوليد. تؤدي إعادة استخدام seed إلى نتائج متسقة وقابلة للتكرار.

POST /run/uso?wait=20 عرض السعر → ⁨‏0.10 $⁩
# 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/uso?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"
    ]
  }'

# 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

حول Uso

يأخذ `input_image_urls` بالترتيب: صورة المحتوى، وصورة النمط، وصورة نمط إضافية اختيارية. يمكن أن تكون المطالبة فارغة لإجراء نقل نمط خالص، ويستبعد `negative_prompt` العناصر غير المرغوبة. يحافظ `keep_size` على تخطيط صورة المحتوى وأبعادها. ينتج من 1 إلى 4 صور في كل تشغيل، مع 1 إلى 50 خطوة وإخراج PNG أو JPEG.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptاختياري
النوعstring
الافتراضي
نص موجّه التوليد؛ اتركه فارغًا لتنفيذ نقل النمط فقط.
input_image_urlsمطلوب
النوعurl[] · image
قائمة عناوين URL للصور بهذا الترتيب: [content_image, style_image, extra_style_image].
image_sizeاختياري
النوعobject
الافتراضيsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد الصورة المُولّدة.
negative_promptاختياري
النوعstring
الافتراضي
المحتوى غير المرغوب في الصورة المراد استبعاده، بما في ذلك العناصر والأنماط والآثار.
num_inference_stepsاختياري
النوعinteger
الافتراضي28
1 – 50
عدد تكرارات إزالة التشويش، إذ يوازن بين مدة توليد أطول وجودة أفضل محتملة مع زيادة العدد.
guidance_scaleاختياري
النوعnumber
الافتراضي4
1 – 10
يتحكم في مدى الالتزام بالموجّه: زد هذه القيمة لجعل النتيجة تتبع الموجّه بدرجة أكبر.
keep_sizeاختياري
النوعboolean
الافتراضيfalse
الحفاظ على حجم صورة المحتوى وترتيبها كما هما عند معالجتها، وهو خيار مفيد لنقل النمط.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المولدة بالتزامن.
seedاختياري
النوعinteger | null
قيمة seed تتحكم في عشوائية التوليد. تؤدي إعادة استخدام seed إلى نتائج متسقة وقابلة للتكرار.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
تمكين اكتشاف محتوى NSFW وتصفيته.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpng
تنسيق صورة المخرج: يحافظ PNG على الشفافية، بينما ينتج JPEG ملفات أصغر.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "uso",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "input_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نتائج اكتشاف NSFW لكل صورة من الصور المولّدة.
prompt
stringالموجّه المستخدم أثناء التوليد.
timings
objectقياسات توقيت الأداء مقسّمة حسب المرحلة.

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