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

متاح عبر APIالجاهزيةصورة

معرف نموذج API

ideogram-character

المدخلات

file

Files API

مطلوب لأوضاع المراجع

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

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

القدرة

صورة

الفوترة

FIXED

حد prompt

5000 أحرف

عقد الطلب

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

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

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

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

سياسة الرفع

ارفع ملفات المراجع أولا، ثم ضع URL وduration token اللذين تم إرجاعهما داخل params.referenceMediaItems.

قاعدة المرجع

صورة مرجعية للشخصية: ارفع ملف صورة واحدا بالضبط لهذا المشروع.

الحد الأقصى للملفات

أنواع الملفات المقبولة

image

Duration token

ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.

kind	الحد الأقصى للحجم	أنواع MIME
image	10 MB	image/jpeg, image/png, image/webp

الطلب الأدنى

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "محتوى اختياري لتجنبه"
  }
}

طلب بملف مرجعي

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "محتوى اختياري لتجنبه",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_ideogram_character_example",
  "status": "queued",
  "model": "ideogram-character",
  "reserved_credits": 18,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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

تتطلب بعض الأوضاع رفع مراجع عبر Files API.

دمج API لنموذج Ideogram Character