مهام الصور غير المتزامنة

تقبل هذه المسارات payload صورة غير متدفق مماثلا للـ endpoint المتزامن. يعيد الإرسال الناجح 202 Accepted وpoll_url وRetry-After؛ استعلم عن URL نفسه بالمفتاح ذاته حتى completed أو failed. عند غياب تخزين مهام الصور في الخادم تعيد الميزة 404 بدلا من قبول العمل.

الإعداد

curl 'https://ai.tavonilo.com/v1/images/generations/async' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"<IMAGE_MODEL_ID>","prompt":"A minimal product illustration"}'

# The 202 response contains poll_url. Query that URL with the same key.

تقبل هذه المسارات payload صورة غير متدفق مماثلا للـ endpoint المتزامن. يعيد الإرسال الناجح 202 Accepted وpoll_url وRetry-After؛ استعلم عن URL نفسه بالمفتاح ذاته حتى completed أو failed. عند غياب تخزين مهام الصور في الخادم تعيد الميزة 404 بدلا من قبول العمل.

التحقق والاسترداد

تحقق من المفتاح بواسطة /v1/models وأرسل طلبا صغيرا غير حساس مرة واحدة، واحتفظ للدعم بالوقت والمسار والنموذج وحالة HTTP وrequest ID فقط. لا يثبت timeout أن التوليد القابل للفوترة لم يعالج، لذلك لا تعيد طلبات الصور أو التوليد الطويل عشوائيا.

حد الأمان

استخدم مفتاحا لكل جهاز أو عبء عمل. لا ترسل أبدا API Key أو auth.json أو موجها خاصا كاملا أو كلمة مرور أو رمز تحقق أو بيانات دفع للدعم؛ ألغ المفتاح واستبدله فورا عند الاشتباه في تسربه.

مستندات ذات صلة

• النماذج والأسعار
• قائمة النماذج
• undefined