استخدم 4o Image عبر Rivya Public API v1 مع معرف النموذج 4o-image، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

متاح عبر APIإدخال النص جاهزصورة

معرف نموذج API

4o-image

المدخلات

text

Files API

غير مطلوب للطلب الأدنى

الرصيد الأساسي

القدرة

صورة

الفوترة

FIXED

حد prompt

لا يوجد حد prompt موثق

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	4o-image	استخدم معرف نموذج API وهو 4o-image.
prompt	string	نعم	-	نص prompt للنماذج التي تدعم إدخال النص.
params	object	لا	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
size	select	لا	1:1	-	1:1, 3:2, 2:3	نسبة الأبعاد

الطلب الأدنى

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

استجابة الإنشاء

يعيد endpoint الإنشاء معرف مهمة عاما. استعلم عن endpoint الحالة حتى تنجح المهمة أو تفشل.

{
  "id": "task_4o_image_example",
  "status": "queued",
  "model": "4o-image",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found