API

Seedream 5.0 Pro API

صورة

تدعم واجهة Seedream 5.0 Pro API إنشاء الصور من النصوص وتعديل الصور المرجعية، مع نسب أبعاد مرنة وإخراج بدقة 1K أو 2K.

التفويضات

Bearerstringheaderمطلوب

مفتاح API لتفويض الطلبات

النص

application/json

modelstringمطلوب

seedream-5-0-pro

input.promptstringمطلوب

صف الصورة التي تريد إنشاءها أو التغييرات التي تريد تطبيقها على الصور المرجعية. تتم إزالة المسافات الزائدة من الأطراف.

input.imagesstring[]اختياري

عناوين URL اختيارية للصور المرجعية. استخدم فقط عناوين HTTPS متاحة للعامة. احذف هذا الحقل عند إنشاء صور من النص.

الحد الأقصى: 16 عناصر.

input.aspect_ratiostringاختياري

نسبة عرض الصورة إلى ارتفاعها. القيمة الافتراضية: 1:1.

الافتراضي: 1:1

1:116:99:163:22:33:44:321:9

input.resolutionstringاختياري

دقة الصورة الناتجة. استخدم القيم بالأحرف الصغيرة 1k أو 2k. القيمة الافتراضية: 1k.

الافتراضي: 1k

1k2k

أمثلة الطلبات

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "صورة منتج سينمائية لكاميرا مستقبلية على شكل موزة",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "seedream-5-0-pro",
    "status": "processing",
    "credits": 50
  }
}

استعلم عن نقطة النهاية هذه باستخدام معرّف المهمة المُعاد حتى تكتمل المهمة أو تفشل. نوصي بالاستعلام كل 5 ثوانٍ للتحقق من أحدث حالة للمهمة.

POST /api/v1/check

{
  "task_id": "task_example"
}

الاستجابة

حالة المهمة التي يعيدها POST /api/v1/check. المعرّفات والروابط والطوابع الزمنية التالية أمثلة توضيحية.

idstringمطلوب

معرّف المهمة في data.id يطابق task_id المُرسل في طلب الاستعلام.

statusstringمطلوب

تعني completed نجاح الإنشاء وتحتوي data.data على النتائج. تكون data.data بقيمة null في الحالات الأخرى.

failed_reasonstringاختياري

يُعاد فقط عندما تكون status بقيمة failed لشرح سبب الفشل. لا يظهر هذا الحقل في completed أو processing.

مكتملة · completed

روابط التنزيل موجودة في data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

الحالات الأخرى

تكون data.data بقيمة null في processing أو failed. يوضح هذا المثال failed: تظهر failed_reason في failed فقط. تابع الاستعلام في processing وأوقفه في failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

استهلاك النقاط

النقاط المستهلكة لطلب يولّد صورة واحدة.

النقاط المستهلكة لطلب يولّد صورة واحدة.
الدقة	1K	2K
صورة واحدة	50	100

بدون المعلمات الاختيارية: 50 نقطة

أرسل معلمات input المدرجة صراحةً لاستخدام السعر المقابل. قد تستهلك الطلبات التي تولّد عدة صور نقاطًا أكثر.

يوضح حقل credits في استجابة POST /api/v1/create عدد النقاط المخصومة للمهمة.