Gebruik Qwen Image 3.0 via Rivya Public API v1 met model-id qwen-image-3, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekst of URL gereed; referentiemodi gebruiken Files APIAfbeelding

API-model-id

qwen-image-3

Inputs

text, file

Files API

Vereist voor referentiemodi

Basiscredits

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

Mogelijkheid

Afbeelding

Facturering

FIXED

Promptlimiet

800 tekens

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	qwen-image-3	Gebruik de API-model-id qwen-image-3.
prompt	string	Ja	-	Maximaal 800 tekens voor dit model.
params	object	Ja	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
resolution	select	Ja	1K	-	1K, 2K	Resolutie
image_size	select	Nee	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Beeldformaat
output_format	select	Nee	png	-	png, jpeg	Uitvoerformaat
prompt_extend	select	Nee	true	-	true, false	Laat het model vóór de generatie een eenvoudige positieve prompt herschrijven, of schakel dit uit voor strakkere controle over de formulering.
nsfw_checker	select	Nee	false	-	false, true	Schakel het optionele inhoudsfilter van het model in. Geen enkel automatisch filter kan volledige dekking garanderen.
negative_prompt	text	Nee	-	-	-	Negatieve prompt
seed	number	Nee	1	min 0 / max 2147483647 / step 1	-	Laat dit leeg voor elke keer een nieuw willekeurig resultaat. Door hetzelfde gehele getal opnieuw te gebruiken, wordt het makkelijker om een eerder resultaat te reproduceren of fijn af te stemmen. Het blijft alleen dichterbij wanneer de prompt en andere belangrijke instellingen ook vergelijkbaar blijven, en het is geen gegarandeerde 1-op-1 match.

Uploadbeleid

Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.

Referentieregel

Referentieafbeeldingen: Upload maximaal drie afbeeldingen in JPEG-, PNG-, WebP-, BMP-, GIF- of TIFF-formaat van elk hoogstens 10 MB.

Max. bestanden

Geaccepteerde bestandstypen

image

Duurtoken

Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.

kind	Max. grootte	MIME-types
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Minimale request

{
  "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": "Optionele elementen of ongewenste resultaten om te vermijden, maximaal 5,000 tekens.",
    "seed": 1
  }
}

Request met referentiebestand

{
  "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": "Optionele elementen of ongewenste resultaten om te vermijden, maximaal 5,000 tekens.",
    "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-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

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

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

Qwen Image 3.0 API-integratie