واجهة API لنماذج Seedream 5.5

المرجع الكامل لواجهة API الخاصة بنماذج Seedream 5.5 من ByteDance.

إصدارات النموذج

تدعم الواجهة إصدارين من النموذج:

مقارنة سريعة

نسب العرض إلى الارتفاع المدعومة

16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9

Seedream 5.5 (توليد الصور من النصوص)

نقطة النهاية

POST /api/v1/image/task

معاملات الطلب

المعاملات المطلوبة

ملاحظة: يجب أن تكون نسبة العرض إلى الارتفاع إحدى النسب التالية: 16:9، 4:3، 3:2، 1:1، 2:3، 3:4، 9:16، 21:9

المعاملات الاختيارية

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.5',
    prompt: 'Editorial fashion portrait, soft window light, muted palette',
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedream 5.5 Edit (تحرير الصور)

نقطة النهاية

POST /api/v1/image/task

معاملات الطلب

المعاملات المطلوبة

ملاحظة: يجب أن تكون نسبة العرض إلى الارتفاع إحدى النسب التالية: 16:9، 4:3، 3:2، 1:1، 2:3، 3:4، 9:16، 21:9

المعاملات الاختيارية

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedream-v5.5-edit',
    prompt: 'Change the hairstyle',
    image_url_list: [
      'https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'
    ],
    resolution: '1.5k',
    width: 16,
    height: 9,
    background: 'auto'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

مثال على تحرير صورة واحدة

javascriptنسخ
{
  model_name: 'seedream-v5.5-edit',
  image_url_list: ['https://img.bestimage.ai/test/2026/7/1/ad8e011a-3e9b-49f0-9397-282bf51e2e45_162640331.jpeg'],
  prompt: 'Change the hairstyle',
  resolution: '1.5k',
  width: 16,
  height: 9,
  background: 'auto'
}

مثال على تحرير صور متعددة

javascriptنسخ
{
  model_name: 'seedream-v5.5-edit',
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg'
  ],
  prompt: 'Blend these images into a cohesive composition',
  resolution: '1.5k',
  width: 16,
  height: 9,
  background: 'auto'
}

تنسيق الاستجابة

الاستجابة الأولية

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "response_url": "https://api.flaq.ai/api/v1/image/0ca5f379-327b-4d49-ba19-e38782ceb2f0",
    "task_status": "submitted"
  }
}

استجابة الاستعلام الدوري

أرسل طلب GET /api/v1/image/{task_id} دوريًا للتحقق من حالة المهمة:

jsonنسخ
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 200,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  },
  "message": "success"
}

استجابة الخطأ

jsonنسخ
{
  "code": 1201,
  "message": "[width, height] Invalid parameter (e.g. wrong key or value)",
  "data": null
}

قيم الحالة

• submitted: قُبلت المهمة
• processing: جارٍ توليد الصورة
• succeed: اكتمل توليد الصورة
• failed: تعذّر توليد الصورة

مدة المعالجة

استعلم دوريًا عن حالة المهمة حتى تصبح succeed أو failed. قد لا تتضمن الاستجابة صورًا بعد إذا كانت المهمة قد أُرسلت للتو أو كانت لا تزال قيد المعالجة.

أفضل الممارسات

1. تفصيل الوصف النصي: يساعد الوصف الأكثر تفصيلًا على تحسين النتائج
2. نسبة العرض إلى الارتفاع: اختر النسبة المناسبة للاستخدام المقصود قبل توليد الصورة
3. جودة الصور عند التحرير: استخدم صورًا أصلية عالية الدقة وجيدة الإضاءة عند التحرير