ابحث عن معرفات نماذج Rivya API، والتوافر، والأوضاع المدعومة، وجداول المعلمات، وحدود الموجه، وقواعد الوسائط المرجعية، وروابط تفاصيل النموذج.

هذه الصفحة هي مرجع API على مستوى النموذج لـ Rivya API v1.

يتم إنشاء الجدول أدناه من كتالوج النماذج نفسه وpublic serializer نفسه المستخدمين في /api/v1/models. إنه ليس عددا ثابتا للنماذج مكتوبا يدويا.

كيفية قراءة هذا المرجع

استخدم id الخاص بالنموذج كقيمة model في POST /api/v1/generations لنماذج الصور والفيديو والصوت غير المتزامنة.
استخدم معرفات نماذج الدردشة في POST /api/v1/chat/completions.
استخدم prompt على المستوى الأعلى لنص موجه التوليد.
استخدم message على المستوى الأعلى لدورات Chat API.
ضع الحقول الخاصة بالنموذج غير المتزامن داخل params.
اقرأ api_input_status قبل بناء التكامل. يمكن اختبار available_text وavailable_url_input من دون رفع ملفات؛ وتعني partial_requires_files أن بعض الأوضاع فقط تحتاج إلى Files API؛ وتعني requires_files_api رفع الوسائط المرجعية عبر Files API قبل استدعاء النموذج.
بالنسبة إلى نماذج الدردشة، اقرأ chat_capabilities لمعرفة دعم الاستجابات غير المتدفقة، وبث SSE، ومرفقات الصور file_id، والبحث في الويب، وthoughts، وreasoning effort.
توفر صفحات تفاصيل النماذج إرشادات وأمثلة على مستوى المنتج.

نمط الطلب

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

لأمثلة JavaScript وPython، راجع إنشاء توليد.

شكل طلب Chat:

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

لأمثلة Chat، راجع Chat API.

مرجع النماذج الديناميكي

استخدم هذا المرجع مع أداة التصحيح

ابدأ من quickstart، ثم أكد حقول النموذج هنا، وبعدها شغّل طلبًا تجريبيًا أو طلبًا فعليًا بعد تسجيل الدخول في أداة Developers للتصحيح.

API Quickstart أداة التصحيح على الإنترنت

Z-Image

z-imageمتاح عبر APIإدخال النص جاهز

صورة · نموذج Alibaba خفيف لتحويل النص إلى صورة. إنشاء سريع لصورة واحدة مع 5 نسب أبعاد، وهو مثالي لمسودات المفاهيم السريعة ومرئيات وسائل التواصل مقابل رصيد واحد فقط.

دليل API صفحة النموذج

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

الأوضاع

text-to-image

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

1000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

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

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2متاح عبر APIجزئي: يلزم Files API

صورة · نموذج الصور الجديد من Google مع دقة 4K، و15 نسبة عرض إلى ارتفاع (بما في ذلك 8:1 المتطرفة)، وتأصيل بحث Google، وما يصل إلى 14 صورة مرجعية - أكثر مولد صور مرونة على Rivya.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

image · 14 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg",
    "google_search": "false"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 14 ملف صورة لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

قد تكون أوضاع prompt أو URL قابلة للاستدعاء الآن. ما زالت أوضاع الوسائط المرجعية تحتاج إلى دعم الرفع عبر Files API. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolution	select	لا	1K	-	1K, 2K, 4K
output_format	select	لا	jpg	-	jpg, png
google_search	select	لا	false	-	false, true

Nano Banana Pro

nano-banana-proمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج الصور الممتاز من Google مع إخراج 4K، و11 نسبة عرض إلى ارتفاع، وما يصل إلى 8 صور مرجعية. محسن لمرئيات العلامات والحملات عالية الدقة مع تفاصيل ودقة ألوان أفضل.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

10000 أحرف

وسائط مرجعية

image · 8 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "nano-banana-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 8 ملفات صور لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolution	select	لا	1K	-	1K, 2K, 4K
output_format	select	لا	png	-	png, jpg

Nano Banana

nano-bananaمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج الصور المرن من Google للنص إلى صورة والصورة إلى صورة، مع 11 نسبة عرض إلى ارتفاع، وما يصل إلى 10 صور مرجعية، وإخراج PNG/JPEG. يناسب بقوة البورتريهات، وتكوينات المنتجات، ومرئيات صفحات الهبوط الأوسع.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 10 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 10 ملفات صور لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
imageSize	select	لا	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_format	select	لا	png	-	png, jpeg

GPT Image 2

gpt-image-2متاح عبر APIجزئي: يلزم Files API

صورة · نموذج GPT Image الأحدث من OpenAI على Rivya، مع نص إلى صورة، وصورة إلى صورة، وما يصل إلى 16 صورة مرجعية، وطبقات أرصدة واضحة بدقة 1K / 2K / 4K.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

image · 16 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

قاعدة المرجع

صور مرجعية: ارفع ما يصل إلى 16 صورة مرجعية لمهام GPT Image 2 من صورة إلى صورة.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	لا	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5متاح عبر APIجزئي: يلزم Files API

صورة · نموذج صور من OpenAI يدعم مستويي جودة medium/high وما يصل إلى 16 صورة مرجعية. يتفوق في اتباع التعليمات المعقدة ورسم مشاهد مترابطة بعلاقات مكانية دقيقة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

وسائط مرجعية

image · 16 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 16 ملف صورة لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
quality	select	لا	medium	-	medium, high
aspect_ratio	select	لا	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageمتاح عبر APIإدخال النص جاهز

صورة · أصبح نموذج 4o Image من OpenAI متاحا الآن كمسار مخصص من النص إلى الصورة على Rivya. يبقي إعداد الصفحة ضيقا عن قصد في الوقت الحالي: موجّه مع 3 نسب أبعاد مدعومة بسعر ثابت قدره 3 أرصدة لكل صورة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

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

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
size	select	لا	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج صور Seedream الأخف من ByteDance مع تسعير مشترك بين النص إلى صورة وتحرير الصور. يدعم 8 نسب عرض إلى ارتفاع، وما يصل إلى 14 صورة مرجعية، وتبلغ تكلفته حاليا 6 أرصدة لكل تشغيل.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

3000 أحرف

وسائط مرجعية

image · 14 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 14 ملف صورة لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	لا	basic	-	basic, high

Seedream 4.5

seedream-4-5متاح عبر APIجزئي: يلزم Files API

صورة · نموذج الصور عالي المستوى من ByteDance مع مستويات جودة 2K/4K، و8 نسب عرض إلى ارتفاع، وما يصل إلى 14 صورة مرجعية. معروف بتدرج ألوان سينمائي وتفاصيل نسيج غنية في مرئيات الأزياء ونمط الحياة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

3000 أحرف

وسائط مرجعية

image · 14 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedream-4-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 14 ملف صورة لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	لا	basic	-	basic, high

Seedream 4.0

seedream-4-0متاح عبر APIجزئي: يلزم Files API

صورة · Seedream 4.0 هو نموذج صور متوازن من ByteDance على Rivya لتوليد النص إلى صورة، وتحرير الصور المرجعية، وعناصر تحكم إخراج واضحة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 10 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

قاعدة المرجع

صور مرجعية: ارفع ما يصل إلى 10 صور لمسار تحرير Seedream 4.0.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9
image_resolution	select	لا	1K	-	1K, 2K, 4K
max_images	number	لا	1	min 1 / max 6 / step 1	-
seed	number	لا	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	لا	false	-	false, true

Seedream 3.0

seedream-3-0متاح عبر APIإدخال النص جاهز

صورة · يعود Seedream 3.0 الآن كنموذج صور قديم مستقل على Rivya. يحتفظ حاليا بمسار النص إلى صورة العام فقط، وتبلغ تكلفته 5 أرصدة لكل تشغيل.

دليل API صفحة النموذج

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

الأوضاع

text-to-image

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	لا	2.5	min 1 / max 10 / step 0.1	-
seed	number	لا	-	min 0 / max 2147483647	-

Grok Imagine

grok-imagineمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج صور من xAI مع تفسير إبداعي قوي و5 نسب عرض إلى ارتفاع. توليد صورة واحدة يركز على التعبير الفني والأساليب البصرية غير التقليدية.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملف صورة واحد لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
enable_pro	select	لا	false	-	false, true

Flux 2 Pro

flux-2-proمتاح عبر APIجزئي: يلزم Files API

صورة · النموذج الرائد من Black Forest Labs بمعاملات 32B. يدعم تحويل النص إلى صورة وتحويل الصورة إلى صورة مع ما يصل إلى 8 صور مرجعية ودقة 2K وعرض دقيق للنصوص، وقد صُمم لصور المنتجات ومرئيات العلامات التجارية.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 8 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

قاعدة المرجع

صورة مرجعية: حمّل ما يصل إلى 8 ملفات صور لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	لا	1K	-	1K, 2K

Flux 2 Flex

flux-2-flexمتاح عبر APIجزئي: يلزم Files API

صورة · النسخة المخصصة للتحرير من عائلة Flux 2. تتخصص في تعديلات البنية ونقل الأسلوب مع ما يصل إلى 8 صور مرجعية ودقة 2K، وهي مثالية للتطوير التكراري على المرئيات الموجودة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 8 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "flux-2-flex",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

قاعدة المرجع

صورة مرجعية: حمّل ما يصل إلى 8 ملفات صور لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	لا	1K	-	1K, 2K

Flux Kontext Max

flux-kontext-maxمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج Flux Kontext المحسّن من Black Forest Labs للتوليد الموجه بالموجّه وتحرير الصور في المهام الصعبة. تتيح Rivya التحويل من النص إلى صورة ومن الصورة إلى صورة في صفحة نموذج واحدة بسعر ثابت قدره 8 أرصدة لكل تشغيل.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "نص علامة مائية اختياري"
  }
}

قاعدة المرجع

صورة مرجعية: حمّل ما يصل إلى ملف صورة واحد لمشاريع تحرير الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	لا	jpeg	-	jpeg, png
enableTranslation	select	لا	true	-	true, false
promptUpsampling	select	لا	false	-	false, true
safetyTolerance	number	لا	2	min 0 / max 6	-
watermark	text	لا	-	-	-

Flux Kontext Pro

flux-kontext-proمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج Flux Kontext الأقل تكلفة من Black Forest Labs للتوليد من النص وتحرير صورة واحدة. تتيح Rivya الوضعين في صفحة نموذج واحدة بسعر ثابت قدره 4 أرصدة لكل تشغيل.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "نص علامة مائية اختياري"
  }
}

قاعدة المرجع

صورة مرجعية: حمّل ما يصل إلى ملف صورة واحد لمشاريع تحرير الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	لا	jpeg	-	jpeg, png
enableTranslation	select	لا	true	-	true, false
promptUpsampling	select	لا	false	-	false, true
safetyTolerance	number	لا	2	min 0 / max 6	-
watermark	text	لا	-	-	-

Qwen2 Image

qwen2-imageمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج صور Qwen2 من Alibaba مدمج حاليا على Rivya كمشروع صور واحد بسعر ثابت. يغطي بأمان النص إلى صورة والصورة إلى صورة عبر مجموعة نسب العرض المشتركة التي تعرضها الوثائق العامة، مع إخراج PNG/JPEG، وإعادة استخدام seed، ومفتاح NSFW بسيط.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

800 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "qwen2-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "16:9",
    "output_format": "png",
    "seed": 0,
    "nsfw_checker": "false"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ملف صورة واحدا كحد أقصى لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
image_size	select	لا	16:9	-	1:1, 3:4, 4:3, 9:16, 16:9
output_format	select	لا	png	-	png, jpeg
seed	number	لا	-	min 0	-
nsfw_checker	select	لا	false	-	false, true

Qwen Image

qwen-imageمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج صور من عائلة Alibaba Qwen مع إعدادات HD مسبقة (مربع، وعمودي، وأفقي) وإخراج PNG/JPEG. قوي في الموجهات باللغة الصينية والتوليد البصري ذي الفروق الثقافية الدقيقة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ملف صورة واحدا كحد أقصى لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	لا	png	-	png, jpeg

Midjourney

midjourneyمتاح عبر APIجزئي: يلزم Files API

صورة · نموذج الصور V7 من Midjourney للتحويل من النص إلى صورة ومن الصورة إلى صورة، مع أوضاع Niji للأنمي و3 فئات سرعة (Relaxed/Fast/Turbo) ومراجع للأسلوب واتساق مدفوع بـ Omni Reference. يناسب الفن السينمائي والرسوم التوضيحية ولوحات الإلهام.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

2000 أحرف

وسائط مرجعية

image · 4 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 4 ملفات صور لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
speed	select	لا	relaxed	-	relaxed, fast, turbo
aspectRatio	select	لا	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	لا	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundمتاح عبر APIيلزم Files API

صورة · نموذج Recraft لإزالة الخلفية على Rivya لعزل الموضوع من صورة موجودة واحدة. استخدمه عندما تحتاج الخطوة التالية إلى أصل شفاف، أو عزل نظيف، أو صورة مصدر من دون الخلفية الأصلية.

دليل API صفحة النموذج

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

الأوضاع

image-to-image

إدخال API

يلزم Files API

المدخلات

file

حد prompt

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مصدر: ارفع صورة واحدة بالضبط. حواف الموضوع الأنظف تنتج عادة عناصر معزولة أنظف.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Recraft Crisp Upscale

recraft-crisp-upscaleمتاح عبر APIيلزم Files API

صورة · نموذج Recraft الخفيف لرفع جودة الصور على Rivya لزيادة الحدة والوضوح بتكلفة منخفضة على صورة ثابتة واحدة معتمدة. استخدمه عندما تحتاج الصورة المختارة إلى تمريرة صقل رخيصة قبل التصدير، لا إلى رفع جودة ثقيل بمستوى التسليم.

دليل API صفحة النموذج

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

الأوضاع

image-to-image

إدخال API

يلزم Files API

المدخلات

file

حد prompt

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مصدر: ارفع صورة واحدة بالضبط. هذا الخيار مخصص لتمريرة صقل سريعة منخفضة التكلفة.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Wan 2.7 Image Pro

wan-2-7-image-proمتاح عبر APIجزئي: يلزم Files API

صورة · Wan 2.7 Image Pro هو نموذج الصور الأعلى مستوى من Alibaba لتحويل النص إلى صورة وتحرير الصور على Rivya. يعيد صورة إخراج واحدة في كل تشغيل بتكلفة ثابتة قدرها 12 رصيدا.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 9 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

قاعدة المرجع

صورة مرجعية: ارفع حتى 9 ملفات صور لمشاريع تحرير الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	لا	2K	-	1K, 2K
watermark	select	لا	false	-	false, true
seed	number	لا	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageمتاح عبر APIجزئي: يلزم Files API

صورة · يدعم نموذج الصور القياسي Wan 2.7 Image من Alibaba تحويل النص إلى صورة وتحرير الصور على Rivya بتكلفة 5 أرصدة لكل تشغيل.

دليل API صفحة النموذج

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

الأوضاع

text-to-image, image-to-image

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 9 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "wan-2-7-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

قاعدة المرجع

صورة مرجعية: ارفع حتى 9 ملفات صور لمشاريع تحرير الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	لا	2K	-	1K, 2K
watermark	select	لا	false	-	false, true
seed	number	لا	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraمتاح عبر APIإدخال النص جاهز

صورة · Google Imagen4 Ultra هو مستوى Imagen المتميز لتحويل النص إلى صورة على Rivya. يتم دمجه حاليا كمشروع لصورة واحدة بسعر ثابت قدره 12 رصيدا، مع عناصر التحكم العامة في الموجّه، والموجّه السلبي، ونسبة العرض إلى الارتفاع، والبذرة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "أشياء اختيارية لتجنبها",
    "seed": "قيمة بذرة اختيارية"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	لا	-	-	-
seed	text	لا	-	-	-

Google Imagen4

google-imagen4متاح عبر APIإدخال النص جاهز

صورة · Google Imagen4 هو مستوى Imagen القياسي لتحويل النص إلى صورة على Rivya. يتم دمجه حاليا كمشروع لصورة واحدة بسعر ثابت قدره 8 أرصدة، مع عناصر التحكم العامة في الموجّه، والموجّه السلبي، ونسبة العرض إلى الارتفاع، والبذرة.

دليل API صفحة النموذج

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

الأوضاع

text-to-image

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "أشياء اختيارية لتجنبها",
    "seed": "قيمة بذرة اختيارية"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	لا	-	-	-
seed	text	لا	-	-	-

Google Imagen4 Fast

google-imagen4-fastمتاح عبر APIإدخال النص جاهز

صورة · Google Imagen4 Fast هو مستوى Imagen الخفيف لتحويل النص إلى صورة على Rivya. يحتفظ حاليا بمشروع لصورة واحدة، ويستخدم سعرا ثابتا قدره 4 أرصدة، ويعرض عناصر التحكم العامة في الموجّه، والموجّه السلبي، ونسبة العرض إلى الارتفاع، والبذرة دون فتح إخراج متعدد الصور.

دليل API صفحة النموذج

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

الأوضاع

text-to-image

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "أشياء اختيارية لتجنبها",
    "seed": 0
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspect_ratio	select	لا	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	لا	-	-	-
seed	number	لا	-	min 0	-

Topaz Image Upscaler

topaz-image-upscaleمتاح عبر APIيلزم Files API

صورة · مكبر الصور من Topaz بدرجة جاهزة للتسليم على Rivya للصور الثابتة المعتمدة التي تحتاج إلى قفزة حقيقية في الحجم. استخدمه عندما يكون التكوين نهائيا بالفعل وتبقى المشكلة في دقة التصدير أو حجم المراجعة أو الجاهزية للطباعة.

دليل API صفحة النموذج

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

الأوضاع

image-to-image

إدخال API

يلزم Files API

المدخلات

file

حد prompt

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة المصدر: ارفع صورة واحدة معتمدة تريد الحفاظ عليها. هذا الخيار للتكبير، وليس لإعادة التحرير الإبداعي.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
upscale_factor	select	لا	1	-	1, 2, 4, 8

Ideogram V3

ideogram-v3متاح عبر APIإدخال النص جاهز

صورة · Ideogram V3 هو نموذج النص إلى صورة في Rivya لتصيير النصوص، وتخطيطات الملصقات، ومطالبات الصور التي تبدأ من التصميم. السعر الحالي هو 4 أرصدة لـ TURBO، و7 لـ BALANCED، و10 لـ QUALITY.

دليل API صفحة النموذج

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

الأوضاع

text-to-image

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "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": "أشياء اختيارية لتجنبها"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
rendering_speed	select	لا	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	لا	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	لا	true	-	true, false
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	لا	-	min 0	-
negative_prompt	text	لا	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframeمتاح عبر APIيلزم Files API

صورة · تم دمج Ideogram V3 Reframe حاليا على Rivya كمشروع إعادة تأطير لصورة واحدة مع تسعير حسب سرعة التصيير. السعر الحالي هو 4 أرصدة لـ TURBO، و7 لـ BALANCED، و10 لـ QUALITY.

دليل API صفحة النموذج

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

الأوضاع

image-to-image

إدخال API

يلزم Files API

المدخلات

file

حد prompt

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

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

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
rendering_speed	select	لا	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	لا	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	لا	-	min 0	-

Ideogram V3 Remix

ideogram-v3-remixمتاح عبر APIيلزم Files API

صورة · تم دمج Ideogram V3 Remix حاليا على Rivya كمشروع إعادة مزج لصورة واحدة مع تسعير حسب سرعة التصيير. السعر الحالي هو 4 أرصدة لـ TURBO، و7 لـ BALANCED، و10 لـ QUALITY.

دليل API صفحة النموذج

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

الأوضاع

image-to-image

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

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

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
rendering_speed	select	لا	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	لا	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	لا	true	-	true, false
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	لا	-	min 0	-
strength	number	لا	0.8	min 0.01 / max 1	-
negative_prompt	text	لا	-	-	-

Ideogram Character

ideogram-characterمتاح عبر APIيلزم Files API

صورة · خيار اتساق الشخصيات لتحويل صورة شخصية واحدة معتمدة إلى مشاهد وملابس وتنسيقات جديدة. استخدمه عندما يكون الحفاظ على الهوية أهم من تحرير الصور الواسع، وعندما تحتاج إلى صورة إخراج واحدة فقط في كل مرة.

دليل API صفحة النموذج

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

الأوضاع

image-to-image

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مرجعية للشخصية: ارفع صورة مرجعية واضحة واحدة للشخصية. يتجاهل هذا الخيار الصور الإضافية ويحافظ على الإخراج كنتيجة واحدة.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
rendering_speed	select	لا	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	لا	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	لا	true	-	true, false
image_size	select	لا	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	لا	-	min 0	-
negative_prompt	text	لا	-	-	-

Seedance 2.0

seedance-2متاح عبر APIإدخال النص جاهز

فيديو · نموذج فيديو Seedance 2.0 الكامل من ByteDance مع دعم واضح للتوليد من الوصف فقط، والتحريك الموجه بالإطارات، والتوليد من مراجع متعددة الوسائط. تبقي Rivya تقسيم الأدوار الموثق واضحا حتى تبقى مدخلات الإطارات والمراجع المتعددة الوسائط منفصلة، بدلا من دمجها في خانة رفع واحدة غامضة.

دليل API صفحة النموذج

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

175

الأوضاع

text-to-video, image-to-video, reference-to-video

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

2500 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedance-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
seedance_scene	select	لا	text	-	text, frames, reference
resolution	select	لا	720p	-	480p, 720p
aspect_ratio	select	لا	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	لا	5	min 4 / max 15	-
generate_audio	select	لا	true	-	true, false
return_last_frame	select	لا	false	-	false, true
web_search	select	لا	false	-	false, true
nsfw_checker	select	لا	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastمتاح عبر APIإدخال النص جاهز

فيديو · نموذج فيديو Seedance 2.0 الأسرع من ByteDance، مع توجيه كامل للمشاهد عبر توليد يعتمد على الوصف فقط، وتحريك الصور الموجه بالإطارات، وتوليد الفيديو من مراجع متعددة الوسائط. تبقي Rivya تقسيم المشاهد الموثق واضحا حتى لا تتداخل مدخلات الإطار الأول أو الأخير مع أدوار الصورة والفيديو والصوت المرجعية.

دليل API صفحة النموذج

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

140

الأوضاع

text-to-video, image-to-video, reference-to-video

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

2500 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedance-2-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
seedance_scene	select	لا	text	-	text, frames, reference
resolution	select	لا	720p	-	480p, 720p
aspect_ratio	select	لا	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	لا	5	min 4 / max 15	-
generate_audio	select	لا	true	-	true, false
return_last_frame	select	لا	false	-	false, true
web_search	select	لا	false	-	false, true
nsfw_checker	select	لا	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو Seedance للتحويل من النص إلى فيديو ومن الصورة إلى فيديو مع مزامنة أصلية بين الصوت والصورة. يدعم 480p إلى 1080p، ومقاطع من 4 إلى 12 ثانية، و6 نسب عرض إلى ارتفاع، وتحكم العدسة الديناميكية أو الثابتة، وتوليد الصوت الاختياري، ومزامنة الشفاه.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

2500 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedance-1-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملفي صورة لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	480p, 720p, 1080p
duration	select	لا	8	-	4, 8, 12
generate_audio	select	لا	false	-	false, true
aspectRatio	select	لا	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	لا	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-proمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج Seedance 1.0 Pro من ByteDance، معروض على Rivya كخيار 1.0 Pro القياسي لكل من النص إلى فيديو والصورة إلى فيديو. يبقي إعداد الصفحة الحالي متوافقا مع وثائق V1 Pro العامة عبر عناصر التحكم في الدقة والمدة وقفل الكاميرا والبذرة وفحص السلامة.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

10000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedance-1-0-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ملف صورة واحدا لتشغيلات الصورة إلى فيديو.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	480p, 720p, 1080p
duration	select	لا	5	-	5, 10
aspect_ratio	select	لا	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	لا	false	-	false, true
seed	number	لا	-1	min -1 / max 2147483647	-
enable_safety_checker	select	لا	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastمتاح عبر APIيلزم Files API

فيديو · نموذج ByteDance السريع للصورة إلى فيديو. يحرك صورة مرجعية واحدة إلى مقاطع 5 أو 10 ثوان بدقة 720p/1080p، وهو محسن للسرعة عندما تحتاج إلى فيديو سريع من صورة ثابتة.

دليل API صفحة النموذج

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

الأوضاع

image-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

10000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مرجعية: ارفع صورة مصدر واحدة لتحريكها إلى فيديو.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	720p, 1080p
duration	select	لا	5	-	5, 10

Seedance 1.0 Lite

seedance-1-0-liteمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج Seedance 1.0 Lite من ByteDance معروض على Rivya كخيار 1.0 الأخف لكل من النص إلى فيديو والصورة إلى فيديو. يتبع مجموعة معلمات V1 Lite العامة، ويستخدم حاليا سلما سعريا أقل من Seedance 1.0 Pro.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

10000 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "seedance-1-0-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع صورة مصدر واحدة للصورة إلى فيديو، أو صورتين عندما تريد أيضا توفير إطار نهاية اختياري.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	480p, 720p, 1080p
duration	select	لا	5	-	5, 10
aspect_ratio	select	لا	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	لا	false	-	false, true
seed	number	لا	-1	min -1 / max 2147483647	-
enable_safety_checker	select	لا	true	-	true, false

HappyHorse 1.0

happyhorse-1-0متاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو AI مرن على Rivya للنص إلى فيديو، وحركة الصورة الواحدة، وفيديو المراجع متعددة الصور، وتحرير الفيديو من صفحة نموذج عامة واحدة.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video, reference-to-video, video-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image, video · 10 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "happyhorse-1-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0
  }
}

قاعدة المرجع

وسائط مرجعية: استخدم ما يصل إلى 9 صور من دون فيديو، أو فيديو واحدا مع ما يصل إلى 5 مراجع صور لتحرير الفيديو.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	1080p	-	720p, 1080p
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	لا	5	min 3 / max 15	-
audio_setting	select	لا	auto	-	auto, origin
seed	number	لا	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoمتاح عبر APIجزئي: يلزم Files API

فيديو · Wan 2.7 Video هو نموذج الفيديو الأحدث من Alibaba مع تسعير حسب الدقة والمدة. تدعم Rivya تحويل النص إلى فيديو، والصورة إلى فيديو، وتحرير الفيديو في نموذج واحد، ابتداء من 80 رصيدا لكل عملية توليد.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video, video-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image, video · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "wan-2-7-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "استبعادات اختيارية أو أوضاع فشل تريد تجنبها.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

قاعدة المرجع

وسائط مرجعية: ارفع حتى أصلين. استخدم ما يصل إلى صورتين لمسار الصورة إلى فيديو، أو فيديو واحدا مع صورة اختيارية واحدة لتحرير الفيديو.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	720p, 1080p
duration	select	لا	5	-	5, 10, 15
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	لا	-	-	-
prompt_extend	select	لا	true	-	true, false
watermark	select	لا	false	-	false, true
audio_setting	select	لا	auto	-	auto, origin
seed	number	لا	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6متاح عبر APIجزئي: يلزم Files API

فيديو · خيار Wan ثلاثي الأوضاع من Alibaba على Rivya: تحويل النص إلى فيديو، والصورة إلى فيديو، وتحرير فيديو المصدر في مشروع واحد. يدعم 720p/1080p، ومقاطع من 5 إلى 15 ثانية، وصورة واحدة أو فيديو مصدر واحدا في كل مرة.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video, video-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image, video · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "wan-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5"
  }
}

قاعدة المرجع

وسائط مرجعية: ارفع حتى ملف صورة / فيديو واحد لمشاريع الصورة / الفيديو.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	720p, 1080p
duration	select	لا	5	-	5, 10, 15

Wan 2.5 Video

wan-2-5-videoمتاح عبر APIجزئي: يلزم Files API

فيديو · أصبح Wan 2.5 متاحا الآن على Rivya كمدخل مشترك واحد لتحويل النص إلى فيديو والصورة إلى فيديو. السعر الحالي هو `720p_5 = 60` و`720p_10 = 120` و`1080p_5 = 100` و`1080p_10 = 200` رصيد.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "wan-2-5-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "استبعادات اختيارية أو أنماط فشل يجب تجنبها.",
    "nsfw_checker": "false"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع حتى ملف صورة واحد لوضع الصورة إلى فيديو.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	720p, 1080p
duration	select	لا	5	-	5, 10
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	لا	false	-	false, true
seed	number	لا	-	min 0 / max 2147483647	-
negative_prompt	text	لا	-	-	-
nsfw_checker	select	لا	false	-	false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboمتاح عبر APIجزئي: يلزم Files API

فيديو · يغطي Wan 2.2 A14B Turbo الآن إنشاء الفيديو من النص، ومن الصورة، إضافة إلى مسار فيديو تقوده صورة وصوت على Rivya. السعر الحالي هو `480p = 8` و`720p = 12` لتشغيل النص أو الصورة، إضافة إلى `480p = 16` و`580p = 20` و`720p = 24` عندما تقود صورة واحدة ومقطع صوتي واحد النتيجة.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video, speech-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image, audio · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "استبعادات اختيارية أو أنماط فشل يجب تجنبها.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

قاعدة المرجع

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

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	720p	-	480p, 580p, 720p
aspect_ratio	select	لا	16:9	-	16:9, 9:16
enable_prompt_expansion	select	لا	false	-	false, true
seed	number	لا	-	min 0 / max 2147483647	-
acceleration	select	لا	none	-	none, regular
num_frames	number	لا	80	min 40 / max 120 / step 1	-
frames_per_second	number	لا	16	min 4 / max 60 / step 1	-
negative_prompt	text	لا	-	-	-
num_inference_steps	number	لا	27	min 2 / max 40 / step 1	-
guidance_scale	number	لا	3.5	min 1 / max 10 / step 0.1	-
shift	number	لا	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	لا	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceمتاح عبر APIإدخال URL جاهز

فيديو · نموذج فيديو استبدال الشخصيات من Wan على Rivya لتبديل من يظهر في مقطع موجود. استخدم عنوان URL عاما واحدا لفيديو المصدر، وعنوان URL عاما واحدا لصورة الاستبدال، ومستوى دقة عندما تكون الحركة صحيحة بالفعل لكن الموضوع المرئي يحتاج إلى تغيير.

دليل API صفحة النموذج

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

الأوضاع

video-to-video

إدخال API

إدخال URL جاهز

المدخلات

url

حد prompt

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "wan-2-2-animate-replace",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://...",
    "image_url": "https://...",
    "resolution": "480p"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يقبل هذا النموذج إدخال URL عام عبر معلمات النموذج.

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
video_url	text	لا	-	-	-
image_url	text	لا	-	-	-
resolution	select	لا	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3متاح عبر APIيلزم Files API

فيديو · نموذج الصورة إلى فيديو من MiniMax مع طبقتي جودة Standard/Pro، ودقة 768P/1080P، ومقاطع 6s أو 10s. معروف بحركة أكثر سلاسة وانتقالات طبيعية من الصور الثابتة.

دليل API صفحة النموذج

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

الأوضاع

image-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملف صورة واحد لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
quality	select	لا	standard	-	standard, pro
resolution	select	لا	768P	-	768P, 1080P
duration	select	لا	6	-	6, 10

Hailuo Pro

hailuo-proمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو Hailuo Pro الأقدم من MiniMax متصل هنا كنموذج ثابت واحد بطبقة Pro لكل من النص إلى فيديو والصورة إلى فيديو. يقبل وضع الصورة 1 أو 2 صورة مرجعية، وتستخدم الصورة الثانية كإطار أخير، وتكلف كل عملية تشغيل حاليا 57 رصيدا.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

1500 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "hailuo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "prompt_optimizer": "false"
  }
}

قاعدة المرجع

صور مرجعية: يقبل وضع الصورة ما يصل إلى صورتين، وتصبح الصورة الثانية الإطار الأخير.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
prompt_optimizer	select	لا	false	-	false, true

Hailuo Standard

hailuo-standardمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو Hailuo Standard الأقدم من MiniMax، موحد هنا كنموذج واحد لكل من النص إلى فيديو والصورة إلى فيديو. يقبل وضع الصورة 1 أو 2 صورة مرجعية، وتستخدم الصورة الثانية كإطار أخير، وتتراوح طبقات التسعير العامة المؤكدة حاليا من 12 إلى 50 رصيدا.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

1500 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "hailuo-standard",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

قاعدة المرجع

صور مرجعية: يقبل وضع الصورة ما يصل إلى صورتين، وتصبح الصورة الثانية الإطار الأخير.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
duration	select	لا	6	-	6, 10
resolution	select	لا	512P	-	512P, 768P
prompt_optimizer	select	لا	false	-	false, true

Kling 3.0

kling-3-0متاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو ممتاز من Kuaishou للنص إلى فيديو والصورة إلى فيديو، مع طبقات قياسي (720P) / احترافي (1080P)، وبنية لقطة واحدة أو متعددة اللقطات، ومدة 3-15s، وتوليد صوت اختياري، وما يصل إلى صورتين مرجعيتين.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

2000 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "kling-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

قاعدة المرجع

وسائط مرجعية: ارفع ما يصل إلى ملفي صور إجمالا لمشاريع الصورة إلى فيديو.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
mode	select	لا	pro	-	std, pro
multi_shots	select	لا	false	-	false, true
duration	select	لا	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
sound	select	لا	false	-	false, true
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlمتاح عبر APIيلزم Files API

فيديو · خيار Kling motion-control أحدث لقيادة موضوع واحد من صورة مرجعية واحدة مع فيديو حركة واحد، مع اختيار صريح لمصدر الخلفية. استخدمه عندما تريد نقل الحركة مع تحكم أقوى في ما إذا كان المشهد يجب أن يأتي من الفيديو أو الصورة.

دليل API صفحة النموذج

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

الأوضاع

video-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

2500 أحرف

وسائط مرجعية

image, video · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مرجعية + فيديو حركة: ارفع صورة شخصية واحدة وفيديو حركة واحدا بالضبط. استخدم 3.0 عندما تحتاج إلى كل من تحكم الاتجاه واختيار مصدر الخلفية.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
mode	select	لا	pro	-	std, pro
character_orientation	select	لا	video	-	video, image
background_source	select	لا	input_video	-	input_video, input_image

Kling 2.6

kling-2-6متاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو من Kuaishou مع توليد صوت اختياري، ومقاطع 5s/10s، و3 نسب عرض إلى ارتفاع. قوي في حركة البشر وتحريك الشخصيات التعبيرية مع فيزياء طبيعية.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

1000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "kling-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملف صورة واحد لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
duration	select	لا	5	-	5, 10
sound	select	لا	false	-	false, true
aspect_ratio	select	لا	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlمتاح عبر APIيلزم Files API

فيديو · مشروع مخصص لنقل الحركة يقود موضوعا واحدا من صورة مرجعية واحدة مع فيديو حركة واحد. استخدمه عندما تريد تمريرة Kling motion-control أرخص ويمكنك الاستغناء عن عناصر التحكم الإضافية في المشهد الموجودة في Kling 3.0 motion-control.

دليل API صفحة النموذج

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

الأوضاع

video-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

2500 أحرف

وسائط مرجعية

image, video · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مرجعية + فيديو حركة: ارفع صورة شخصية واحدة وفيديو حركة واحدا بالضبط. ينبغي أن يظهر في كليهما الرأس والكتفان والجذع بوضوح.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
mode	select	لا	720p	-	720p, 1080p
character_orientation	select	لا	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج الفيديو Kling V2.5 Turbo Pro من Kuaishou، ويدعم الآن كلا من النص إلى فيديو والصورة إلى فيديو. تغطي أدلة التسعير العامة بوضوح طبقات النص والصورة لمدة 5 ثوان و10 ثوان، لذلك تربطه Rivya مباشرة بـ 42 / 84 رصيدا.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

2500 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "صف ما ينبغي أن يتجنبه الفيديو",
    "cfg_scale": 0.5
  }
}

قاعدة المرجع

صور مرجعية: ارفع اختياريا ما يصل إلى صورتين للانتقال إلى وضع الصورة إلى فيديو؛ وتعيّن الصورة الثانية إلى إطار الذيل.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
duration	select	لا	5	-	5, 10
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	لا	-	-	-
cfg_scale	number	لا	0.5	min 0 / max 1	-

Kling V2.1 Master

kling-v2-1-masterمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو Kling V2.1 Master الأقدم من Kuaishou يدعم الآن كلا من النص إلى فيديو والصورة إلى فيديو على Rivya. السعر الحالي هو 160 رصيدا لمدة 5 ثوان و320 رصيدا لمدة 10 ثوان.

دليل API صفحة النموذج

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

160

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "kling-v2-1-master",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "صف ما ينبغي أن يتجنبه الفيديو",
    "cfg_scale": 0.5
  }
}

قاعدة المرجع

صورة مرجعية: يمكنك رفع صورة واحدة اختياريا للانتقال إلى وضع الصورة إلى فيديو؛ اتركها فارغة للبقاء في وضع النص.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
duration	select	لا	5	-	5, 10
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	لا	-	-	-
cfg_scale	number	لا	0.5	min 0 / max 1	-

Kling V2.1 Pro

kling-v2-1-proمتاح عبر APIيلزم Files API

فيديو · نموذج Kling V2.1 Pro الأقدم من Kuaishou للصورة إلى فيديو يدعم إطارا أولا مع صورة إطار ذيل اختيارية. السعر الحالي هو 50 رصيدا لمدة 5 ثوان و100 رصيد لمدة 10 ثوان.

دليل API صفحة النموذج

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

الأوضاع

image-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صور مرجعية: يقبل وضع الصورة ما يصل إلى ملفي صور، وتعيّن الصورة الثانية إلى إطار الذيل.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
duration	select	لا	5	-	5, 10
negative_prompt	text	لا	-	-	-
cfg_scale	number	لا	0.5	min 0 / max 1	-

Kling V2.1 Standard

kling-v2-1-standardمتاح عبر APIيلزم Files API

فيديو · نموذج Kling V2.1 Standard الأقدم من Kuaishou للصورة إلى فيديو. السعر الحالي هو 25 رصيدا لمدة 5 ثوان و50 رصيدا لمدة 10 ثوان.

دليل API صفحة النموذج

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

الأوضاع

image-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة مرجعية: يقبل وضع الصورة ملف صورة واحدا كإطار أول.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
duration	select	لا	5	-	5, 10
negative_prompt	text	لا	-	-	-
cfg_scale	number	لا	0.5	min 0 / max 1	-

Kling AI Avatar Pro

kling-ai-avatar-proمتاح عبر APIيلزم Files API

فيديو · نموذج Kling AI Avatar Pro الأعلى جودة من Kuaishou لإنشاء avatar ناطق، يستخدم صورة بورتريه واحدة مع مقطع صوتي واحد لتوليد فيديو avatar متزامن الشفاه. تسعره Rivya حاليا بسعر ثابت قدره 16 رصيدا لكل عملية توليد.

دليل API صفحة النموذج

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

الأوضاع

image-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image, audio · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة بورتريه وصوت: ارفع صورة بورتريه واحدة ومقطعا صوتيا واحدا معا.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Kling AI Avatar Standard

kling-ai-avatar-standardمتاح عبر APIيلزم Files API

فيديو · نموذج Kling AI Avatar Standard من Kuaishou لإنشاء avatar ناطق، يستخدم صورة بورتريه واحدة مع مقطع صوتي واحد لتوليد فيديو avatar متزامن الشفاه. تسعره Rivya حاليا بسعر ثابت قدره 8 أرصدة لكل عملية توليد.

دليل API صفحة النموذج

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

الأوضاع

image-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image, audio · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة بورتريه وصوت: ارفع صورة بورتريه واحدة ومقطعا صوتيا واحدا معا.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Infinitalk

infinitalkمتاح عبر APIيلزم Files API

فيديو · Infinitalk هو نموذج فيديو ناطق يعتمد على بورتريه وصوت. يتم قياس السعر الحالي حسب الدقة ومدة الصوت: 480p = 3 أرصدة في الثانية و720p = 12 رصيدا في الثانية.

دليل API صفحة النموذج

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

الأوضاع

image-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

image, audio · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

صورة بورتريه وصوت: ارفع صورة بورتريه واحدة ومقطعا صوتيا واحدا معا.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
resolution	select	لا	480p	-	480p, 720p
seed	number	لا	-	min 10000 / max 1000000	-

Runway

runwayمتاح عبر APIجزئي: يلزم Files API

فيديو · Runway نموذج فيديو مستقل يدعم كلا من النص إلى فيديو والصورة إلى فيديو. تؤكد أدلة التسعير العامة حاليا 6 طبقات توليد فقط، لذلك تبقيه Rivya على المجموعة المتحققة: `720p_5 = 12`، و`720p_10 = 30`، و`1080p_5 = 30`.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

1800 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "اتركه فارغا لتعطيل العلامة المائية"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع اختياريا صورة واحدة للانتقال إلى وضع الصورة إلى فيديو؛ واتركه فارغا للبقاء في وضع النص.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
duration	select	لا	5	-	5, 10
quality	select	لا	720p	-	720p, 1080p
aspectRatio	select	لا	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	لا	-	-	-

Runway Aleph

runway-alephمتاح عبر APIيلزم Files API

فيديو · مشروع تحويل فيديو مصدر لإعادة صياغة مقطع موجود إلى نتيجة بصرية جديدة. استخدم Aleph عندما تأتي الحركة من لقطات الإدخال لديك ويأتي الاتجاه الإبداعي من الموجه، مع سعر ثابت قدره 90 رصيدا.

دليل API صفحة النموذج

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

الأوضاع

video-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

5000 أحرف

وسائط مرجعية

video, image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

وسائط الإدخال: ارفع مقطع المصدر الذي تريد أن يحوله Aleph. أضف صورة ثابتة اختيارية واحدة فقط عندما تحتاج إلى توجيه إضافي للأسلوب أو الموضوع.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	لا	-	-	-
seed	number	لا	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoمتاح عبر APIيلزم Files API

فيديو · مدخل مستقل لإعادة كتابة فيديو مصدر ودفع مقطع موجود إلى اتجاه بصري جديد. استخدمه عندما ينبغي أن يحول الموجه اللقطات نفسها، لا أن يحسن وضوح التصدير فقط.

دليل API صفحة النموذج

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

الأوضاع

video-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

وسائط مرجعية

video · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

فيديو الإدخال: ارفع مقطع مصدر قصيرا واحدا تريد تحويله. يعيد هذا الخيار كتابة اللقطات بدلا من تحسينها ببساطة.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
watermark	text	لا	-	-	-

Grok Imagine Video

grok-imagine-videoمتاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو من xAI مع أوضاع إبداعية Fun/Normal/Spicy و5 نسب عرض إلى ارتفاع. إعدادات أسلوبية فريدة لنبرات إبداعية مختلفة، من المرح إلى السينمائي إلى الجريء.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "normal",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "2:3"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملف صورة واحد لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
mode	select	لا	normal	-	fun, normal, spicy
duration	number	لا	6	min 6 / max 30 / step 1	-
resolution	select	لا	480p	-	480p, 720p
aspect_ratio	select	لا	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proمتاح عبر APIجزئي: يلزم Files API

فيديو · المستوى الاحترافي من Sora 2 مع وضعي جودة Standard/High، ومقاطع 10 ثوان أو 15 ثانية، وإزالة العلامة المائية. يوفر تفاصيل وإضاءة ووفاء حركة محسنة لإنتاج الفيديو الاحترافي.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

10000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "sora-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملف صورة واحد لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
size	select	لا	-	-	standard, high
n_frames	select	لا	10	-	10, 15
aspect_ratio	select	لا	landscape	-	landscape, portrait
remove_watermark	select	لا	false	-	false, true
upload_method	select	لا	s3	-	s3, oss

Sora 2

sora-2متاح عبر APIجزئي: يلزم Files API

فيديو · نموذج فيديو OpenAI للنص إلى فيديو والصورة إلى فيديو، مع محاكاة عالم واقعية، وصوت متزامن، ومقاطع 10 ثوان أو 15 ثانية، وإخراج أفقي أو عمودي، وإزالة اختيارية للعلامة المائية.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

10000 أحرف

وسائط مرجعية

image · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "sora-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملف صورة واحد لمشاريع الصور.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
n_frames	select	لا	10	-	10, 15
aspect_ratio	select	لا	landscape	-	landscape, portrait
remove_watermark	select	لا	false	-	false, true
upload_method	select	لا	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerمتاح عبر APIإدخال URL جاهز

فيديو · نموذج المعالجة اللاحقة لإزالة العلامة المائية من Sora على Rivya للروابط العامة المكتملة من Sora. استخدمه بعد اكتمال الفيديو بالفعل عندما تكون المهمة المتبقية هي إزالة العلامة المائية مع اختيار تسليم S3 أو OSS.

دليل API صفحة النموذج

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

الأوضاع

video-to-video

إدخال API

إدخال URL جاهز

المدخلات

url

حد prompt

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "sora-watermark-remover",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://sora.chatgpt.com/p/...",
    "upload_method": "s3"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يقبل هذا النموذج إدخال URL عام عبر معلمات النموذج.

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
video_url	text	نعم	-	-	-
upload_method	select	نعم	s3	-	s3, oss

Topaz Video Upscaler

topaz-video-upscaleمتاح عبر APIيلزم Files API

فيديو · مكبر الفيديو من Topaz بدرجة جاهزة للتسليم على Rivya للمقاطع المعتمدة التي تحتاج فقط إلى وضوح أكبر عند التصدير. استخدمه عندما تكون اللقطة والحركة والتوقيت صحيحة بالفعل وتبقى المشكلة في الدقة أو حدة الملف النهائي.

دليل API صفحة النموذج

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

الأوضاع

video-to-video

إدخال API

يلزم Files API

المدخلات

file

حد prompt

وسائط مرجعية

video · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

فيديو المصدر: ارفع مقطع مصدر واحدا تريد الحفاظ عليه. هذا الخيار يحسن وضوح التسليم بدلا من تغيير اللقطة.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
upscale_factor	select	لا	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityمتاح عبر APIجزئي: يلزم Files API

فيديو · إصدار Google Veo 3.1 الذي يضع الجودة أولا لإنشاء فيديوهات مميزة من النص أو بالاعتماد على الصور. تمنحه المرئيات الأعلى دقة، وواقعية الحركة الأقوى، والصوت الخلفي المدمج افتراضيا مكانة خيار Veo الأعلى مستوى داخل Rivya.

دليل API صفحة النموذج

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

150

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "نص علامة مائية اختياري",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع حتى ملفي صور للمشروع المعتمد على الصور والمدعوم حاليا.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	16:9	-	16:9, 9:16, Auto
watermark	text	لا	-	-	-
seeds	number	لا	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	لا	true	-	true, false

Veo3.1 Fast

veo3-1-fastمتاح عبر APIجزئي: يلزم Files API

فيديو · النسخة السريعة من Google Veo 3.1 مع دعم ثلاثي الأوضاع: النص إلى فيديو، والصورة إلى فيديو، والمرجع إلى فيديو. ما يصل إلى 3 صور مرجعية، وصوت أصلي، وعناصر تحكم في نسبة العرض إلى الارتفاع واعية بالوضع تجعلها مفيدة لمقاطع سينمائية سريعة.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video, reference-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 3 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "نص علامة مائية اختياري",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى 3 ملفات صور لمشاريع الصور والمشاريع القائمة على المراجع.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
generationType	select	لا	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	لا	16:9	-	16:9, 9:16, Auto
watermark	text	لا	-	-	-
seeds	number	لا	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	لا	true	-	true, false

Veo3.1 Lite

veo3-1-liteمتاح عبر APIجزئي: يلزم Files API

فيديو · أقل متغيرات Google Veo 3.1 تكلفة. تعرض Rivya حاليا أصغر مجموعة مستقرة فقط: النص إلى فيديو والصورة إلى فيديو بسعر ثابت قدره `10` أرصدة لكل عملية توليد.

دليل API صفحة النموذج

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

الأوضاع

text-to-video, image-to-video

إدخال API

جزئي: يلزم Files API

المدخلات

text, file

حد prompt

5000 أحرف

وسائط مرجعية

image · 2 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "نص علامة مائية اختياري",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

قاعدة المرجع

صورة مرجعية: ارفع ما يصل إلى ملفي صورة للمشروع المدفوع بالصور المدعوم.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
aspectRatio	select	لا	16:9	-	16:9, 9:16, Auto
watermark	text	لا	-	-	-
seeds	number	لا	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	لا	true	-	true, false

Suno Music

suno-musicمتاح عبر APIإدخال النص جاهز

صوت · Suno Music هو نموذج Rivya للنص إلى موسيقى، يحول موجزا قصيرا واحدا إلى مسودة أغنية أولى مع غناء أو من دونه. يحافظ على نقطة الدخول الثابتة عند `12` رصيدا ويعرض `Extend Music` كخطوة تالية بعد نجاح المسار.

دليل API صفحة النموذج

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

الأوضاع

text-to-audio

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

500 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "suno-music",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
model	select	لا	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	لا	false	-	false, true

Suno Sounds

suno-soundsمتاح عبر APIإدخال النص جاهز

صوت · Suno Sounds هو نموذج Rivya الخفيف لتحويل النص إلى صوت، مناسب لحلقات الأجواء وصوت الخلفية والمسودات الصوتية القصيرة. يحافظ على السعر الثابت الموثق عند `3` أرصدة لكل عملية توليد، ويتيح للنتائج الناجحة المتابعة إلى `Vocal Separation`.

دليل API صفحة النموذج

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

الأوضاع

text-to-audio

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

500 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "suno-sounds",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
model	select	لا	V5	-	V5, V5_5
soundLoop	select	لا	false	-	false, true
soundTempo	number	لا	-	min 1 / max 300 / step 1	-
soundKey	select	لا	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsمتاح عبر APIإدخال النص جاهز

صوت · Suno Lyrics هو نموذج توليد كلمات الأغاني في Rivya لتحويل موضوع أو حالة مزاجية واحدة إلى كلمات أغنية بتكلفة ثابتة قدرها `1` رصيد لكل طلب.

دليل API صفحة النموذج

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

الأوضاع

text-to-audio

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

200 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "suno-lyrics",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3متاح عبر APIإدخال النص جاهز

صوت · نموذج الحوار متعدد المتحدثين من ElevenLabs على Rivya. صُمم لتوليد كلام قائم على الأدوار، مع تعيين صوت لكل شخصية، وتحكم في الثبات، وإيقاع جاهز للحوار للبودكاست والمقابلات ومشاهد الشخصيات.

دليل API صفحة النموذج

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

الأوضاع

dialogue-to-audio

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
default_voice	select	لا	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	لا	0.5	-	0, 0.5, 1
language_code	text	لا	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5متاح عبر APIإدخال النص جاهز

صوت · نموذج تحويل النص إلى كلام السريع من ElevenLabs على Rivya. مع توليد صوت منخفض التأخير وثبات وتشابه وأسلوب وسرعة قابلة للضبط، صُمم لمسودات التعليق الصوتي السريعة ومشاريع تحويل النص إلى كلام التفاعلية.

دليل API صفحة النموذج

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

الأوضاع

text-to-speech

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "سياق اختياري قبل هذا السطر",
    "next_text": "سياق اختياري بعد هذا السطر",
    "language_code": "رمز لغة اختياري مثل en أو zh"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
voice	select	نعم	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	لا	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	لا	0.75	min 0 / max 1 / step 0.05	-
style	number	لا	0	min 0 / max 1 / step 0.05	-
speed	number	لا	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	لا	false	-	false, true
previous_text	text	لا	-	-	-
next_text	text	لا	-	-	-
language_code	text	لا	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2متاح عبر APIإدخال النص جاهز

صوت · نموذج تحويل النص إلى كلام متعدد اللغات من ElevenLabs على Rivya، يدعم نحو 30 لغة مع الكشف التلقائي. إنه الخيار الأقوى للتوطين، والأداء عبر اللغات، والتعليقات الصوتية متعددة اللغات الأكثر طبيعية.

دليل API صفحة النموذج

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

الأوضاع

text-to-speech

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "elevenlabs-multilingual-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
voice	select	نعم	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	لا	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	لا	0.75	min 0 / max 1 / step 0.05	-
style	number	لا	0	min 0 / max 1 / step 0.05	-
speed	number	لا	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	لا	false	-	false, true
previous_text	text	لا	-	-	-
next_text	text	لا	-	-	-
language_code	text	لا	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2متاح عبر APIإدخال النص جاهز

صوت · نموذج تحويل النص إلى صوت من ElevenLabs على Rivya للمؤثرات القصيرة، والانتقالات، وحلقات الأجواء. أنشئ مقاطع صوتية من 0.5 إلى 22 ثانية مع قوة تأثير قابلة للضبط للموجّه، ووضع الحلقة، و19 صيغة إخراج لمشاريع التحرير أو المنتجات أو الألعاب.

دليل API صفحة النموذج

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

الأوضاع

text-to-audio

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

5000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

المعلمات

key	النوع	مطلوب	الافتراضي	النطاق	الخيارات
loop	select	لا	false	-	false, true
duration_seconds	number	لا	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	لا	0.3	min 0 / max 1 / step 0.05	-
output_format	select	لا	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationمتاح عبر APIيلزم Files API

صوت · نموذج تنظيف الصوت وعزل الصوت البشري من ElevenLabs على Rivya. ارفع تسجيلا واحدا لعزل الصوت البشري، وإزالة ضوضاء الخلفية، وتنظيف الصوت المنطوق قبل التحرير أو النشر.

دليل API صفحة النموذج

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

الأوضاع

audio-to-audio

إدخال API

يلزم Files API

المدخلات

file

حد prompt

وسائط مرجعية

audio · 1 ملف/ملفات

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

لا يظهر مثال Public API قابل للتشغيل لهذا النموذج.

قاعدة المرجع

الملف الصوتي الأصلي: ارفع ملفا صوتيا واحدا وستعزل Rivya المسار المستهدف وتنظفه.

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

تحتاج الأوضاع القائمة على الملفات إلى /api/v1/files قبل عرضها كأمثلة API جاهزة كاملة. Files API

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5.5

gpt-5-5-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج دردشة GPT متقدم من OpenAI على Rivya، مناسب للاستدلال المعقد، والتحليل الواعي بالصور، وتوليف الأبحاث، والكتابة المنظمة عندما يحتاج الملخص إلى مساحة أكبر.

دليل API صفحة النموذج

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

الأوضاع

responses

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5.4

gpt-5-4-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج محادثة AI أعلى مستوى من OpenAI على Rivya، مع قدرة أقوى على التعامل مع المدخلات المنظمة، والتحكم في الاستدلال، ومشاريع المحادثة الموجهة للأدوات لمهام التحليل والكتابة الأكثر تعقيدا.

دليل API صفحة النموذج

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

الأوضاع

responses

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5-4-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5.4 Codex

gpt-5.4-codex-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج Codex أعلى مستوى من OpenAI على Rivya، مع برمجة أقوى، واستدلال منظم، وتعاون موجه للأدوات لمشاريع التطوير عالية المتطلبات على مستوى المستودع.

دليل API صفحة النموذج

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

الأوضاع

responses

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5.4-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5.3 Codex

gpt-5-3-codex-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج Codex من فئة عالية على Rivya لتصحيح الأخطاء الصعبة وتخطيط التنفيذ طويل السياق ومراجعة الكود في المهام المتطلبة.

دليل API صفحة النموذج

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

الأوضاع

responses

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5-3-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5.2

gpt-5-2-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج دردشة عام من OpenAI على Rivya باستدلال متقدم ودعم رؤية لما يصل إلى 6 صور ونافذة سياق 20K حرف. يناسب البحث والتخطيط والكتابة والتحليل الواعي بالصور.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5-2-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5.2 Codex

gpt-5-2-codex-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج Codex الأكثر تقدما من OpenAI على Rivya، مع استدلال أقوى للمهام الهندسية المعقدة. إنه محسّن للبرمجة الوكيلية طويلة الأفق، وقرارات المعمارية، وعمليات إعادة الهيكلة الأكبر عندما لا يكفي توليد الكود العادي.

دليل API صفحة النموذج

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

الأوضاع

responses

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5-2-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5.1 Codex

gpt-5-1-codex-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج Codex المحدّث من OpenAI على Rivya، مع دقة كود محسّنة واستدلال أقوى لمهام البرمجة الوكيلية. يحافظ على مشروع طويل المخرجات وواع بالمستودع نفسه، مع تحسين إعادة الهيكلة متعددة الملفات وتحرير الكود الأكثر أمانا.

دليل API صفحة النموذج

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

الأوضاع

responses

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5-1-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

GPT-5 Codex

gpt-5-codex-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج GPT-5 Codex المتخصص في الكود من OpenAI على Rivya، مناسب للتصحيح، وتخطيط التنفيذ، وإعادة الهيكلة، وحل المشكلات التقنية مع دعم للرؤية.

دليل API صفحة النموذج

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

الأوضاع

responses

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gpt-5-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Gemini 3.1 Pro

gemini-3-1-pro-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج دردشة Gemini AI متقدم على Rivya للمهام التحليلية والإبداعية الصعبة التي تتطلب استدلالا متأنيا ورؤية واتباعا دقيقا للتعليمات.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gemini-3-1-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Gemini 3 Pro

gemini-3-pro-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج دردشة Gemini AI الأعلى عمقا من Google على Rivya. مع استدلال أقوى من Gemini 2.5 Pro ودعم للرؤية، يناسب البحث المركب، والكتابة التقنية، والتحليل متعدد الوسائط الأكثر تأنيا.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gemini-3-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Gemini 3 Flash

gemini-3-flash-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج دردشة Gemini AI سريع على Rivya بتكلفة token أقل من Gemini 2.5 Flash. يناسب الدردشة متعددة الوسائط كبيرة الحجم وفرز لقطات الشاشة وعمل المساعد السريع.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gemini-3-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Gemini 2.5 Pro

gemini-2-5-pro-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج دردشة Gemini AI الأكثر تقدمًا من Google على Rivya. بفضل استدلال أقوى من Flash ودعم الرؤية وسياق 20K، يناسب تركيب الأبحاث وتحليل المستندات والكتابة المنظمة.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gemini-2-5-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Gemini 2.5 Flash

gemini-2-5-flash-chatمتاح عبر APIإدخال النص جاهز

دردشة · نموذج دردشة Gemini سريع ومراع للتكلفة من Google على Rivya. بفضل دعم الرؤية لما يصل إلى 6 صور، يناسب الأسئلة السريعة والملخصات الأولية وفرز لقطات الشاشة والمساعدة اليومية بالذكاء الاصطناعي.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text, file

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "gemini-2-5-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. يجب أن تستخدم مرفقات الصور قيم file_id من Files API.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Claude Opus 4.7

claude-opus-4-7-chatمتاح عبر APIإدخال النص جاهز

محادثة · نموذج محادثة Claude الرائد من Anthropic على Rivya للاستدلال العميق، والتركيب المتأني، والكتابة التنفيذية، وأعمال النص عالية التأثير.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "claude-opus-4-7-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. لا يدعم نموذج Chat هذا مرفقات الصور.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Claude Opus 4.6

claude-opus-4-6-chatمتاح عبر APIإدخال النص جاهز

محادثة · نموذج محادثة Claude AI مميز على Rivya للاستدلال العميق والتحليل المعقد والكتابة عالية الجودة في المشاريع الصعبة.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "claude-opus-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. لا يدعم نموذج Chat هذا مرفقات الصور.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Claude Sonnet 4.6

claude-sonnet-4-6-chatمتاح عبر APIإدخال النص جاهز

محادثة · نموذج محادثة Claude AI المتوازن من Anthropic على Rivya. يحافظ على استدلال طويل قوي وتحليل متأن لمشاريع المحتوى والبحث والبرمجة دون القفز إلى إنفاق بمستوى Opus.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "claude-sonnet-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. لا يدعم نموذج Chat هذا مرفقات الصور.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Claude Opus 4.5

claude-opus-4-5-chatمتاح عبر APIإدخال النص جاهز

محادثة · نموذج محادثة Claude AI مميز على Rivya للاستدلال العميق والتحليل المعقد والكتابة الاحترافية عندما تكون الجودة أهم من السرعة.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "claude-opus-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. لا يدعم نموذج Chat هذا مرفقات الصور.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Claude Sonnet 4.5

claude-sonnet-4-5-chatمتاح عبر APIإدخال النص جاهز

محادثة · نموذج محادثة Claude AI المتوازن من Anthropic على Rivya. يتميز في الكتابة الدقيقة، والتحليل المتأني، والاستجابات الواعية بالسلامة، ما يجعله خيار Claude قويا لإنشاء المحتوى والبحث.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "claude-sonnet-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. لا يدعم نموذج Chat هذا مرفقات الصور.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

Claude Haiku 4.5

claude-haiku-4-5-chatمتاح عبر APIإدخال النص جاهز

محادثة · نموذج محادثة Claude AI الخفيف من Anthropic على Rivya. تم ضبطه للسرعة وكفاءة التكلفة والأداء اليومي المستقر في مشاريع عالية التكرار تريد فيها نبرة Claude دون إنفاق مميز.

دليل API صفحة النموذج

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

الأوضاع

chat-completion

إدخال API

إدخال النص جاهز

المدخلات

text

حد prompt

20000 أحرف

وسائط مرجعية

الطلب

POST /api/v1/generations

المصادقة

مفتاح Bearer API

Idempotency-Key

موصى به

جسم الطلب

{
  "model": "claude-haiku-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

قاعدة المرجع

النتيجة

تعيد استجابة الإنشاء معرف مهمة عامًا. استعلم عن GET /api/v1/generations/{taskId} حتى تصبح الحالة succeeded أو failed.

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

validation_failed, insufficient_credits, idempotency_conflict, not_found

يدعم Chat API أدوار المحادثة غير المتدفقة وSSE streaming في Public API v1. لا يدعم نموذج Chat هذا مرفقات الصور.

المعلمات

لا توجد معلمة نموذج إضافية مطلوبة.

مرجع Model API

كيفية قراءة هذا المرجع

نمط الطلب

مرجع النماذج الديناميكي

استخدم هذا المرجع مع أداة التصحيح

Z-Image

جسم الطلب

المعلمات

Nano Banana 2

جسم الطلب

المعلمات

Nano Banana Pro

جسم الطلب

المعلمات

Nano Banana

جسم الطلب

المعلمات

GPT Image 2

جسم الطلب

المعلمات

GPT Image 1.5

جسم الطلب

المعلمات

4o Image

جسم الطلب

المعلمات

Seedream 5.0 Lite

جسم الطلب

المعلمات

Seedream 4.5

جسم الطلب

المعلمات

Seedream 4.0

جسم الطلب

المعلمات

Seedream 3.0

جسم الطلب

المعلمات

Grok Imagine

جسم الطلب

المعلمات

Flux 2 Pro

جسم الطلب

المعلمات

Flux 2 Flex

جسم الطلب

المعلمات

Flux Kontext Max

جسم الطلب

المعلمات

Flux Kontext Pro

جسم الطلب

المعلمات

Qwen2 Image

جسم الطلب

المعلمات

Qwen Image

جسم الطلب

المعلمات

Midjourney

جسم الطلب

المعلمات

Recraft Remove Background

جسم الطلب

المعلمات

Recraft Crisp Upscale

جسم الطلب

المعلمات

Wan 2.7 Image Pro

جسم الطلب

المعلمات

Wan 2.7 Image

جسم الطلب

المعلمات

Google Imagen4 Ultra

جسم الطلب

المعلمات

Google Imagen4

جسم الطلب

المعلمات