Rivya Public API v1 के जरिए मॉडल ID qwen-image-3, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Qwen Image 3.0 का उपयोग करें।

API से उपलब्धटेक्स्ट या URL तैयार; संदर्भ मोड में Files API का उपयोग होता हैइमेज

API मॉडल ID

qwen-image-3

इनपुट

text, file

Files API

संदर्भ मोड के लिए जरूरी

बेस क्रेडिट

per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉

क्षमता

इमेज

बिलिंग

FIXED

प्रॉम्प्ट सीमा

800 अक्षर

रिक्वेस्ट संरचना

मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।

कुंजी	प्रकार	जरूरी	डिफॉल्ट	विवरण
model	string	हां	qwen-image-3	qwen-image-3 API मॉडल ID का उपयोग करें।
prompt	string	हां	-	इस मॉडल के लिए अधिकतम 800 अक्षर।
params	object	हां	-	मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें।
client_request_id	string	नहीं	-	अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID।

मॉडल पैरामीटर

कुंजी	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
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	Generation से पहले मॉडल को सरल positive prompt दोबारा लिखने दें, या wording पर ज्यादा नियंत्रण के लिए इसे बंद करें।
nsfw_checker	select	नहीं	false	-	false, true	मॉडल का optional content filter चालू करें। कोई भी automated filter पूरी coverage की गारंटी नहीं दे सकता।
negative_prompt	text	नहीं	-	-	-	नेगेटिव प्रॉम्प्ट
seed	number	नहीं	1	min 0 / max 2147483647 / step 1	-	हर बार नया यादृच्छिक नतीजा पाने के लिए इसे खाली छोड़ें। वही पूर्णांक दोबारा इस्तेमाल करने से पिछले नतीजे को दोहराना या बारीक समायोजित करना आसान होता है। नतीजा तभी ज्यादा करीब रहता है जब प्रॉम्प्ट और बाकी मुख्य सेटिंग भी मिलती-जुलती रहें; फिर भी यह 1:1 मिलान की गारंटी नहीं है।

अपलोड नीति

पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और durationToken को params.referenceMediaItems में रखें।

संदर्भ नियम

रेफरेंस इमेज: अधिकतम तीन JPEG, PNG, WebP, BMP, GIF या TIFF images upload करें; हर image 10 MB से बड़ी नहीं होनी चाहिए।

अधिकतम फाइलें

स्वीकार्य फाइल प्रकार

image

durationToken

अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।

kind	अधिकतम आकार	MIME प्रकार
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

न्यूनतम रिक्वेस्ट

{
  "model": "qwen-image-3",
  "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": "Optional elements या failure modes जिनसे बचना है, अधिकतम 5,000 characters।",
    "seed": 1
  }
}

संदर्भ फाइल रिक्वेस्ट

{
  "model": "qwen-image-3",
  "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": "Optional elements या failure modes जिनसे बचना है, अधिकतम 5,000 characters।",
    "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"
      }
    ]
  }
}

Create रिस्पॉन्स

create एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।

{
  "id": "task_qwen_image_3_example",
  "status": "queued",
  "model": "qwen-image-3",
  "reserved_credits": 5,
  "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 संदर्भ अपलोड जरूरी हैं।

Qwen Image 3.0 API इंटीग्रेशन