ใช้ Qwen2 Image ผ่าน Rivya Public API v1 ด้วย model id qwen2-image, input ที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่าง response

พร้อมใช้งานผ่าน APIText หรือ URL พร้อม; โหมด reference ใช้ Files APIรูปภาพ

ID โมเดล API

qwen2-image

Input

text, file

Files API

จำเป็นสำหรับโหมด reference

เครดิตพื้นฐาน

ความสามารถ

รูปภาพ

Billing

FIXED

ขีดจำกัดพรอมต์

800 อักขระ

contract ของ request

ส่ง model id ที่ระดับบนสุด control เฉพาะโมเดลอยู่ใน params

Key	Type	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
model	string	ใช่	qwen2-image	ใช้ API model id qwen2-image
prompt	string	ใช่	-	สูงสุด 800 อักขระสำหรับโมเดลนี้
params	object	ไม่ใช่	-	object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต
client_request_id	string	ไม่ใช่	-	client-side id แบบเลือกได้สำหรับ trace คำขอในระบบของคุณ

พารามิเตอร์โมเดล

Key	Type	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
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	-	เว้นว่างไว้เพื่อสร้างผลลัพธ์แบบสุ่มใหม่ทุกครั้ง การใช้เลขจำนวนเต็มเดิมซ้ำจะช่วยให้ทำซ้ำหรือปรับละเอียดจากผลลัพธ์ก่อนหน้าได้ง่ายขึ้น ผลลัพธ์จะใกล้เคียงขึ้นเมื่อพรอมป์และการตั้งค่าหลักอื่นยังคล้ายเดิมเท่านั้น และไม่รับประกันว่าจะตรงกันแบบ 1:1
nsfw_checker	select	ไม่ใช่	false	-	false, true	ตัวกรองเนื้อหา

policy การอัปโหลด

อัปโหลดไฟล์ reference ก่อน จากนั้นใส่ URL และ duration token ที่ได้กลับมาไว้ใน params.referenceMediaItems

กฎ reference

ภาพอ้างอิง: อัปโหลดไฟล์รูปภาพได้สูงสุด 1 ไฟล์สำหรับโปรเจกต์รูปภาพ

ไฟล์สูงสุด

ชนิดไฟล์ที่รับ

image

Duration token

reference วิดีโอและเสียงควรมี durationToken จาก /api/v1/files เมื่อจำเป็นต้องตรวจ duration

kind	ขนาดสูงสุด	MIME type
image	10 MB	image/jpeg, image/png, image/webp

request ขั้นต่ำ

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

request แบบไฟล์ reference

{
  "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",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

response จากการสร้าง

endpoint create ส่ง public task id กลับมา poll endpoint สถานะจนกว่างานจะสำเร็จหรือล้มเหลว

{
  "id": "task_qwen2_image_example",
  "status": "queued",
  "model": "qwen2-image",
  "reserved_credits": 6,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

error ทั่วไป

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

บางโหมดต้องใช้การอัปโหลด reference ผ่าน Files API

การเชื่อมต่อ API ของ Qwen2 Image