Qwen Image 3.0 modelini Rivya Public API v1 üzerinden model id qwen-image-3, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin veya URL hazır; referans modları Files API kullanırGörsel

API model kimliği

qwen-image-3

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

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

Yetenek

Görsel

Faturalandırma

FIXED

Prompt limiti

800 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	qwen-image-3	qwen-image-3 API model kimliği değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 800 karakter.
params	object	Evet	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
resolution	select	Evet	1K	-	1K, 2K	Çözünürlük
image_size	select	Hayır	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Görsel boyutu
output_format	select	Hayır	png	-	png, jpeg	Çıktı biçimi
prompt_extend	select	Hayır	true	-	true, false	Modelin üretimden önce basit bir pozitif istemi yeniden yazmasına izin verin veya ifade üzerinde daha sıkı kontrol için bu özelliği kapatın.
nsfw_checker	select	Hayır	false	-	false, true	Modelin isteğe bağlı içerik filtresini etkinleştirin. Hiçbir otomatik filtre eksiksiz kapsama garantisi veremez.
negative_prompt	text	Hayır	-	-	-	Negatif istem
seed	number	Hayır	1	min 0 / max 2147483647 / step 1	-	Her seferinde yeni bir rastgele sonuç için boş bırakın. Aynı tam sayıyı yeniden kullanmak, önceki bir sonucu yeniden üretmeyi veya ince ayar yapmayı kolaylaştırır. Yalnızca istem ve diğer temel ayarlar da benzer kaldığında sonuca daha yakın durur; bire bir eşleşme garanti değildir.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Referans görseller: Her biri en fazla 10 MB olan üç adede kadar JPEG, PNG, WebP, BMP, GIF veya TIFF görsel yükleyin.

Maks. dosya

Kabul edilen dosya türleri

image

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Minimal istek

{
  "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": "İsteğe bağlı olarak kaçınılacak öğeleri veya hata türlerini yazın; en fazla 5,000 karakter.",
    "seed": 1
  }
}

Referans dosyalı istek

{
  "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": "İsteğe bağlı olarak kaçınılacak öğeleri veya hata türlerini yazın; en fazla 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"
      }
    ]
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

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

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Qwen Image 3.0 API Entegrasyonu