Rivya Public API v1 দিয়ে Qwen Image 3.0 ব্যবহার করুন: model id qwen-image-3, সমর্থিত ইনপুট, প্যারামিটার, Files API নিয়ম, ক্রেডিট এবং response উদাহরণসহ।

API দিয়ে উপলভ্যটেক্সট বা URL প্রস্তুত; reference modes Files API ব্যবহার করেছবি

API model id

qwen-image-3

ইনপুট

text, file

Files API

reference mode-এর জন্য প্রয়োজন

বেস ক্রেডিট

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

ক্ষমতা

ছবি

বিলিং

FIXED

প্রম্পট সীমা

800 অক্ষর

রিকোয়েস্ট contract

model id top level-এ পাঠান। Model-specific control params-এ থাকবে।

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	বিবরণ
model	string	হ্যাঁ	qwen-image-3	qwen-image-3 API model id ব্যবহার করুন।
prompt	string	হ্যাঁ	-	এই model-এর জন্য সর্বোচ্চ 800 অক্ষর।
params	object	হ্যাঁ	-	মডেল-নির্দিষ্ট প্যারামিটার object। অনুমোদিত key-এর জন্য নিচের row ব্যবহার করুন।
client_request_id	string	না	-	আপনার সিস্টেমে request trace করার ঐচ্ছিক client-side id।

মডেল প্যারামিটার

Key	ধরন	প্রয়োজনীয়	ডিফল্ট	পরিসর	বিকল্প	বিবরণ
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	-	প্রতিবার নতুন random result চাইলে empty রাখুন। একই integer reuse করলে আগের result reproduce বা fine-tune করা সহজ হয়। Prompt এবং অন্য key setting একই রকম থাকলেই শুধু result কাছাকাছি থাকে, এবং এটি guaranteed 1:1 match নয়।

আপলোড নীতি

প্রথমে reference file upload করুন, তারপর ফেরত পাওয়া URL এবং duration token params.referenceMediaItems-এর মধ্যে দিন।

রেফারেন্স নিয়ম

রেফারেন্স ছবি: সর্বোচ্চ তিনটি JPEG, PNG, WebP, BMP, GIF বা TIFF ছবি আপলোড করুন, প্রতিটির আকার 10 MB-এর বেশি নয়।

সর্বোচ্চ ফাইল

সমর্থিত ফাইল ধরন

image

Duration token

duration verification প্রয়োজন হলে video এবং audio reference /api/v1/files থেকে durationToken বহন করবে।

kind	সর্বোচ্চ আকার	MIME types
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

ন্যূনতম request

{
  "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": "ঐচ্ছিকভাবে এড়ানোর উপাদান বা ত্রুটি লিখুন, সর্বোচ্চ 5,000 অক্ষর।",
    "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": "ঐচ্ছিকভাবে এড়ানোর উপাদান বা ত্রুটি লিখুন, সর্বোচ্চ 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"
      }
    ]
  }
}

Create response

create endpoint public task id ফেরত দেয়। task succeeded বা failed না হওয়া পর্যন্ত status endpoint poll করুন।

{
  "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

কিছু mode-এর জন্য Files API reference upload দরকার।

Qwen Image 3.0 API ইন্টিগ্রেশন