استخدم Ideogram V3 عبر Rivya Public API v1 مع معرف النموذج ideogram-v3، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

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

معرف نموذج API

ideogram-v3

المدخلات

text

Files API

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

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

القدرة

صورة

الفوترة

FIXED

حد prompt

5000 أحرف

عقد الطلب

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

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	ideogram-v3	استخدم معرف نموذج API وهو ideogram-v3.
prompt	string	نعم	-	الحد الأقصى لهذا النموذج هو 5000 حرفا.
params	object	لا	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

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

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
rendering_speed	select	لا	BALANCED	-	TURBO, BALANCED, QUALITY	توازن بين السرعة والتكلفة والتفاصيل. Turbo هو الأسرع والأرخص، وQuality هو الأكثر تفصيلا والأعلى تكلفة، وBalanced هو الخيار الأوسط الافتراضي.
style	select	لا	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN	الأسلوب
expand_prompt	select	لا	true	-	true, false	مفتاح توسيع prompt في Ideogram. يساعد تشغيله النموذج على تفصيل وصفك؛ وإيقافه أفضل عندما تريد تحكما دقيقا في prompt.
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	حجم الصورة
seed	number	لا	-	min 0	-	اتركه فارغا للحصول على نتيجة عشوائية جديدة في كل مرة. إعادة استخدام العدد الصحيح نفسه تسهّل إعادة إنتاج نتيجة سابقة أو ضبطها. تكون النتيجة أقرب فقط عندما يبقى prompt والإعدادات الرئيسية الأخرى متشابهة أيضا، ولا يضمن ذلك تطابقا 1:1.
negative_prompt	text	لا	-	-	-	المطالبة السلبية

الطلب الأدنى

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "أشياء اختيارية لتجنبها"
  }
}

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

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

{
  "id": "task_ideogram_v3_example",
  "status": "queued",
  "model": "ideogram-v3",
  "reserved_credits": 7,
  "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