الصور

إنشاء عملية توليد

يحتوي الطلب على model وprompt ومعلمات العناصر القابلة للتطبيق فقط: الحجم أو نسبة الأبعاد أو التنسيق أو عدد النتائج.

لا تستخدم نموذج نص كمعرّف لنموذج صور: اختر النموذج بحسب نوع الوسائط المبيّن له في الكتالوج.

curl --request POST https://cicora.ai/api/v1/images \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/gemini-2.5-flash-image",
    "prompt": "A precise editorial illustration of a delivery route at dusk",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

المراجع والتحرير

• أرسل الصور المرجعية عبر input_references، وبالشكل الذي يدعمه النموذج المختار فقط.
• يستخدم تحويل صورة إلى صورة والتحرير مسار /images نفسه مع مرجع المصدر وتعليمة نصية.
• تحقق من نوع MIME وحجم ملف الإدخال وحقوقه قبل إرساله.

استلام العنصر

في الاستجابة المتوافقة، اقرأ data[].b64_json بوصفها بايتات صورة؛ ويمكن لـ media_type تحديد التنسيق. احتفظ بالبيانات الوصفية مع المطالبة والنموذج.

لا تنشر نتيجة جزئية كأنها نهائية. مع التسليم عبر البث، ميّز حدث المسودة عن العنصر المكتمل.