استخدم Qwen Image 3.0 Pro عبر Rivya Public API v1 مع معرف النموذج qwen-image-3-pro، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.

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

معرف نموذج API

qwen-image-3-pro

المدخلات

text, file

Files API

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

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

per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉

القدرة

صورة

الفوترة

FIXED

حد prompt

800 أحرف

عقد الطلب

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

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

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

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
resolution	select	نعم	1K	-	1K, 2K	الدقة
image_size	select	لا	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	حجم الصورة
output_format	select	لا	png	-	png, jpeg	تنسيق الإخراج
prompt_extend	select	لا	true	-	true, false	دع النموذج يعيد صياغة موجّه إيجابي بسيط قبل التوليد، أو عطّل الخيار للتحكم الأدق في الصياغة.
nsfw_checker	select	لا	false	-	false, true	فعّل مرشح المحتوى الاختياري للنموذج. لا يمكن لأي مرشح آلي ضمان التغطية الكاملة.
negative_prompt	text	لا	-	-	-	الموجّه السلبي
seed	number	لا	1	min 0 / max 2147483647 / step 1	-	اتركه فارغا للحصول على نتيجة عشوائية جديدة في كل مرة. إعادة استخدام العدد الصحيح نفسه تسهّل إعادة إنتاج نتيجة سابقة أو ضبطها. تكون النتيجة أقرب فقط عندما يبقى الموجّه والإعدادات الرئيسية الأخرى متشابهة أيضا، ولا يضمن ذلك تطابقا 1:1.

سياسة الرفع

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

قاعدة المرجع

الصور المرجعية: ارفع ما يصل إلى ثلاث صور بتنسيق JPEG أو PNG أو WebP أو BMP أو GIF أو TIFF، على ألا يزيد حجم كل منها على 10 MB.

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

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

image

Duration token

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

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

الطلب الأدنى

{
  "model": "qwen-image-3-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "عناصر أو أنماط إخفاق اختيارية تريد تجنبها، حتى 5,000 حرف.",
    "seed": 1
  }
}

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

{
  "model": "qwen-image-3-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "عناصر أو أنماط إخفاق اختيارية تريد تجنبها، حتى 5,000 حرف.",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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

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

{
  "id": "task_qwen_image_3_pro_example",
  "status": "queued",
  "model": "qwen-image-3-pro",
  "reserved_credits": 7,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

دمج API لنموذج Qwen Image 3.0 Pro