Gunakan Qwen Image 3.0 melalui Rivya Public API v1 dengan id model qwen-image-3, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIGambar

ID model API

qwen-image-3

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

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

Kapabilitas

Gambar

Tagihan

FIXED

Batas prompt

800 karakter

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	qwen-image-3	Gunakan qwen-image-3 sebagai id model API.
prompt	string	Ya	-	Maksimum 800 karakter untuk model ini.
params	object	Ya	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
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	Ukuran gambar
output_format	select	Tidak	png	-	png, jpeg	Format keluaran
prompt_extend	select	Tidak	true	-	true, false	Biarkan model menulis ulang prompt positif sederhana sebelum pembuatan, atau nonaktifkan untuk mengendalikan susunan kata dengan lebih ketat.
nsfw_checker	select	Tidak	false	-	false, true	Aktifkan filter konten opsional pada model. Tidak ada filter otomatis yang dapat menjamin cakupan sepenuhnya.
negative_prompt	text	Tidak	-	-	-	Prompt negatif
seed	number	Tidak	1	min 0 / max 2147483647 / step 1	-	Biarkan kosong untuk hasil acak baru setiap kali. Menggunakan ulang integer yang sama membuat hasil sebelumnya lebih mudah direproduksi atau disempurnakan. Hasil hanya akan lebih dekat bila prompt dan pengaturan kunci lain juga tetap mirip, dan ini bukan jaminan kecocokan 1:1.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Gambar referensi: Unggah hingga tiga gambar JPEG, PNG, WebP, BMP, GIF, atau TIFF, masing-masing tidak lebih dari 10 MB.

File maksimum

Jenis file yang diterima

image

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kind	Ukuran maksimum	Tipe MIME
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Request minimal

{
  "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 hasil gagal opsional yang perlu dihindari, hingga 5.000 karakter.",
    "seed": 1
  }
}

Request file referensi

{
  "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 hasil gagal opsional yang perlu dihindari, hingga 5.000 karakter.",
    "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"
      }
    ]
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil 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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.

Integrasi API Qwen Image 3.0