استخدم Flux Kontext Max عبر Rivya Public API v1 مع معرف النموذج flux-kontext-max، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

متاح عبر APIالنص أو URL جاهز؛ تستخدم أوضاع المراجع Files APIالصورة

معرف نموذج API

flux-kontext-max

المدخلات

text, file

Files API

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

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

القدرة

الصورة

الفوترة

FIXED

حد prompt

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

عقد الطلب

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

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

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

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
aspectRatio	select	لا	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	نسبة العرض إلى الارتفاع
outputFormat	select	لا	jpeg	-	jpeg, png	JPEG أصغر حجما، بينما PNG أفضل للشفافية أو للحواف النظيفة دون فقد.
enableTranslation	select	لا	true	-	true, false	ترجمة النص تلقائيا
promptUpsampling	select	لا	false	-	false, true	عند التفعيل، تتيح Rivya للنموذج توسيع النص وتحسينه قبل التوليد. يساعد ذلك غالبا جودة التفاصيل، لكنه قد يجعل النتيجة أكثر تأويلا من نصك الخام.
safetyTolerance	number	لا	2	min 0 / max 6	-	يتحكم في مدى صرامة الإشراف على المحتوى. يسمح التوليد عادة بنطاق أوسع من التحرير؛ القيم المنخفضة أكثر صرامة والقيم الأعلى أكثر تساهلا.
watermark	text	لا	-	-	-	العلامة المائية

سياسة الرفع

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

قاعدة المرجع

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

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

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

image

Duration token

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

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

الطلب الأدنى

{
  "model": "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": "نص علامة مائية اختياري"
  }
}

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

{
  "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": "نص علامة مائية اختياري",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_flux_kontext_max_example",
  "status": "queued",
  "model": "flux-kontext-max",
  "reserved_credits": 8,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

دمج API لنموذج Flux Kontext Max