تعليمات تكامل واجهة برمجة تطبيقات توليد الصور SeeDream

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

عملية التقديم

​

الاستخدام الأساسي

• accept: نوع الاستجابة المرغوب استلامها، هنا يتم تحديدها كـ application/json أي بصيغة JSON.
• authorization: مفتاح استدعاء API، يمكن اختياره من القائمة بعد التقديم.

• prompt: كلمة التوجيه.
• model: نموذج التوليد، الافتراضي هو doubao-seedream-5.0-lite. يدعم النماذج doubao-seedream-5.0-lite (الأحدث)، doubao-seedream-4.5، doubao-seedream-4.0، doubao-seedream-3.0-t2i، وdoubao-seededit-3.0-i2i.
• image: معلومات الصورة المدخلة، تدعم URL أو ترميز Base64. حيث يدعم doubao-seedream-5.0-lite، doubao-seedream-4.5، وdoubao-seedream-4.0 إدخال صورة واحدة أو متعددة، بينما يدعم doubao-seededit-3.0-i2i صورة واحدة فقط، وdoubao-seedream-3.0-t2i لا يدعم هذا المعامل.
• size: تحديد أبعاد الصورة الناتجة، ويدعم طريقتين لا يمكن دمجهما:
  • الطريقة 1 | تحديد دقة الصورة الناتجة مع وصف نسبة العرض إلى الارتفاع باستخدام لغة طبيعية في prompt. تختلف الإعدادات المسبقة المدعومة حسب النموذج: يدعم doubao-seedream-5.0-lite دقات 2K/3K/4K؛ وdoubao-seedream-4.5 يدعم فقط 2K/4K؛ وdoubao-seedream-4.0 يدعم 1K/2K/4K؛ بينما doubao-seedream-3.0-t2i وdoubao-seededit-3.0-i2i لا يدعمان الإعدادات المسبقة ويقبلان فقط الطريقة 2.
  • الطريقة 2 | تحديد أبعاد الصورة بوحدات البكسل: الافتراضي 2048x2048، مع نطاقات مختلفة لإجمالي البكسلات ونسبة العرض إلى الارتفاع حسب النموذج (مثلاً الحد الأدنى لإجمالي البكسلات في 5.0 / 4.5 هو 3,686,400، وفي 4.0 هو 921,600، ونطاق 3.0-t2i / seededit-3.0-i2i هو [512x512, 2048x2048]).
• seed: بذرة رقم عشوائي للتحكم في عشوائية المحتوى الناتج. نطاق القيم [-1, 2147483647]. يدعمه فقط doubao-seedream-3.0-t2i.
• sequential_image_generation: توليد مجموعة صور مرتبطة بناءً على المحتوى المدخل. يدعم هذا المعامل doubao-seedream-5.0-lite، doubao-seedream-4.5، وdoubao-seedream-4.0، والافتراضي هو disabled.
• stream: التحكم في تفعيل وضع الإخراج المتدفق. يدعمه doubao-seedream-5.0-lite، doubao-seedream-4.5، وdoubao-seedream-4.0، والافتراضي false.
• guidance_scale: درجة التوافق بين ناتج النموذج وprompt، كلما زادت القيمة زادت الصلة. نطاق القيم [1, 10]. القيمة الافتراضية لـ doubao-seedream-3.0-t2i هي 2.5، ولـ doubao-seededit-3.0-i2i هي 5.5، ولا يدعمها النماذج الأخرى.
• response_format: تحديد صيغة استرجاع الصورة الناتجة. الافتراضي url، ويدعم أيضًا b64_json.
• watermark: تحديد ما إذا كانت الصورة الناتجة تحتوي على علامة مائية. الافتراضي true.
• output_format: تحديد صيغة ملف الصورة الناتجة، يدعم jpeg (الافتراضي) وpng. يدعمه فقط doubao-seedream-5.0-lite.
• tools: إعداد الأدوات التي يستدعيها النموذج، حاليًا يدعم web_search (بحث عبر الإنترنت). يدعمه فقط doubao-seedream-5.0-lite.
• callback_url: عنوان URL لاستقبال نتائج الاستدعاء العكسي.

{
  "success": true,
  "task_id": "25027ba3-0430-4a1b-91c8-d2297f19ba73",
  "trace_id": "8043a9e9-692f-43b0-82f7-5890f798be38",
  "data": [
    {
      "prompt": "a white siamese cat",
      "size": "2048x2048",
      "image_url": "https://platform.cdn.xhuoapi.ai/seedream/3c060029-69b1-406f-a957-fcd55ddc9386.jpg"
    }
  ]
}

• success: حالة مهمة توليد الصورة.
• task_id: معرف مهمة توليد الصورة.
• trace_id: معرف تتبع المهمة.
• data: قائمة نتائج مهمة توليد الصورة.
  • image_url: رابط الصورة الناتجة.
  • prompt: كلمة التوجيه.
  • size: أبعاد الصورة الناتجة بالبكسل.

curl -X POST 'https://api.xhuoapi.ai/v1/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "doubao-seedream-4-0-250828",
  "prompt": "a white siamese cat"
}'

​

مهمة تحرير الصور

• model: النموذج المستخدم لمهمة تحرير الصورة، يدعم doubao-seedream-5.0-lite، doubao-seedream-4.5، وdoubao-seedream-4.0 إدخال صورة واحدة أو متعددة، وdoubao-seededit-3.0-i2i يدعم صورة واحدة فقط.
• image: تحميل الصورة أو الصور المراد تحريرها.

import requests

url = "https://api.xhuoapi.ai/v1/flux/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedream-4-0-250828",
  "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
  "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"],
  "size": "2K",
  "watermark": False
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.xhuoapi.ai/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

​

الاستدعاء العكسي غير المتزامن

{
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde"
}

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.xhuoapi.ai/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

​

معالجة الأخطاء

• 400 token_mismatched: طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صحيحة.
• 400 api_not_implemented: طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صحيحة.
• 401 invalid_token: غير مصرح، رمز تفويض مفقود أو غير صحيح.
• 429 too_many_requests: عدد الطلبات كبير جدًا، تجاوزت الحد المسموح.
• 500 api_error: خطأ داخلي في الخادم.

​

مثال على استجابة الخطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

الخلاصة