توليد الصور

​

متى تستخدم كل نقطة نهاية

​

اختر نموذجًا

curl "https://api.tokenlab.sh/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

• العملية المدعومة، مثل text-to-image، image-to-image، أو image-edit.
• نقطة النهاية المتوقعة من قبل النموذج.
• الشكل الذي يجب استخدامه للمرجع، مثل image_url، image_urls، reference_image_urls، image متعدد الأجزاء، أو images[] بتنسيق JSON.
• ما إذا كان النموذج يقبل size، aspect_ratio، resolution، quality، background، output_format، أو response_format.

​

قواعد شكل الطلب

• تستخدم طلبات نمط gpt-image-2 حقول size، quality، وحقول التحرير على غرار OpenAI. في الإنشاء والتحرير، يقبل background القيمتين auto وopaque، ولا يدعم transparent. اترك الحقول الاختيارية عند رغبتك في أن يستخدم النموذج أو TokenLab القيم الافتراضية التلقائية.
• عادةً ما تستخدم عائلات الصور Gemini وNano Banana aspect_ratio؛ أرسل resolution فقط عندما يكشف تفاصيل النموذج عنها.
• ينتمي تحويل الصورة إلى صورة Nano Banana إلى /v1/images/generations مع operation: "image-to-image" وعناوين URL للصور المرجعية.
• لا تقبل /v1/images/generations images[] أو file_id على المستوى الأعلى؛ تلك هي أشكال تدفق التحرير.
• يجب أن تكون مراجع الصور البعيدة عناوين URL عامة http أو https. لا ترسل عناوين URL لشبكة خاصة، أو بيانات اعتماد مضمنة، أو أجزاء URL، أو عناوين URL موقعة قد تنتهي صلاحيتها قبل بدء المعالجة.

​

مثال تحويل النص إلى صورة

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "صورة منتج نظيفة لكوب قهوة خزفي على مكتب من الجوز",
    "size": "1024x1024",
    "response_format": "url"
  }'

​

مثال صورة مرجعية

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "operation": "image-to-image",
    "prompt": "احتفظ بشكل المنتج، غير الخلفية إلى إعداد استوديو مشرق",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1"
  }'

​

التعامل مع النتائج

• تعيد الاستجابات المتزامنة data[] النهائية مع url أو b64_json.
• تعيد الاستجابات غير المتزامنة id، task_id، status، وعادةً poll_url.
• يفضل استخدام poll_url عندما يكون موجودًا. إذا كنت بحاجة إلى مسار ثابت، استعلم عن GET /v1/tasks/{id}.
• استخدم الطلبات المتزامنة عندما تحتاج تحديدًا إلى b64_json؛ نتائج الصور غير المتزامنة موجهة نحو URL.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

​

قائمة التحقق للإنتاج

• تحقق من مدخلات المستخدم قبل استدعاء TokenLab: طول الموجه، عدد الصور، إمكانية الوصول إلى URL، ونوع الملف.
• اضبط مهلات HTTP عالية بما يكفي للطلبات المتزامنة عالية الدقة. استخدم الوضع غير المتزامن حيثما كان متاحًا للأعمال الطويلة.
• قم بتخزين request_id، task_id، poll_url، النموذج، نقطة النهاية، وشكل الطلب المنظف للدعم.
• عند انتهاء مهلة العميل، تحقق مما إذا تم إنشاء مهمة قبل إعادة محاولة طلب الإنشاء.
• قم بمصالحة التكلفة مع سجلات الاستخدام وbilling_transaction_id عند وجودها، وليس مع معرفات مهام المزود.

​

الأخطاء الشائعة

​

مرجع API