Gunakan Qwen Image 3.0 melalui Rivya Public API v1 dengan ID model qwen-image-3, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APITeks atau URL sedia; mod rujukan menggunakan Files APIImej

ID model API

qwen-image-3

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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

Keupayaan

Imej

Bil

FIXED

Had prompt

800 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	qwen-image-3	Gunakan ID model API qwen-image-3.
prompt	string	Ya	-	Maksimum 800 aksara untuk model ini.
params	object	Ya	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
resolution	select	Ya	1K	-	1K, 2K	Resolusi
image_size	select	Tidak	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Saiz imej
output_format	select	Tidak	png	-	png, jpeg	Format output
prompt_extend	select	Tidak	true	-	true, false	Benarkan model menulis semula prompt positif yang ringkas sebelum penjanaan, atau lumpuhkannya untuk kawalan kata yang lebih ketat.
nsfw_checker	select	Tidak	false	-	false, true	Aktifkan penapis kandungan pilihan model. Tiada penapis automatik yang dapat menjamin liputan lengkap.
negative_prompt	text	Tidak	-	-	-	Prompt negatif
seed	number	Tidak	1	min 0 / max 2147483647 / step 1	-	Biarkan kosong untuk hasil rawak baharu setiap kali. Menggunakan semula nombor bulat yang sama memudahkan anda menghasilkan semula atau memperhalus hasil sebelumnya. Hasil hanya kekal lebih hampir apabila prompt dan tetapan utama lain juga masih serupa, dan ia bukan padanan 1:1 yang dijamin.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Imej rujukan: Muat naik sehingga tiga imej JPEG, PNG, WebP, BMP, GIF atau TIFF, setiap satu tidak melebihi 10 MB.

Fail maksimum

Jenis fail diterima

image

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Permintaan minimum

{
  "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": "Elemen atau jenis kegagalan pilihan untuk dielakkan, sehingga 5,000 aksara.",
    "seed": 1
  }
}

Permintaan fail rujukan

{
  "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": "Elemen atau jenis kegagalan pilihan untuk dielakkan, sehingga 5,000 aksara.",
    "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"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

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

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Qwen Image 3.0