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

พร้อมใช้งานผ่าน APIข้อความหรือ URL พร้อม; โหมดอ้างอิงใช้ Files APIรูปภาพ

ID โมเดล API

qwen-image

อินพุต

text, file

Files API

จำเป็นสำหรับโหมดอ้างอิง

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

ความสามารถ

รูปภาพ

การชำระเงิน

FIXED

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

5000 อักขระ

สัญญาของคำขอ

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

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

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

คีย์	ประเภท	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
image_size	select	ไม่ใช่	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	ขนาดรูปภาพ
output_format	select	ไม่ใช่	png	-	png, jpeg	รูปแบบเอาต์พุต

นโยบายการอัปโหลด

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

กฎอ้างอิง

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

ไฟล์สูงสุด

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

image

Duration token

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

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

คำขอขั้นต่ำ

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

คำขอแบบไฟล์อ้างอิง

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

คำตอบจากการสร้าง

endpoint create ส่ง ID งานสาธารณะกลับมา ให้ตรวจ endpoint สถานะซ้ำจนกว่างานจะสำเร็จหรือล้มเหลว

{
  "id": "task_qwen_image_example",
  "status": "queued",
  "model": "qwen-image",
  "reserved_credits": 4,
  "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 ของ Qwen Image