Brug Qwen Image 3.0 via Rivya Public API v1 med model-id qwen-image-3, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekst eller URL klar; referencetilstande bruger Files APIBillede

API-model-id

qwen-image-3

Inputs

text, file

Files API

Krævet for referencetilstande

Basiscredits

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

Funktion

Billede

Fakturering

FIXED

Promptgrænse

800 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

Nøgle	Type	Krævet	Standard	Beskrivelse
model	string	Ja	qwen-image-3	Brug API-model-id'et qwen-image-3.
prompt	string	Ja	-	Maksimalt 800 tegn for denne model.
params	object	Ja	-	Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_id	string	Nej	-	Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

Nøgle	Type	Krævet	Standard	Interval	Valgmuligheder	Beskrivelse
resolution	select	Ja	1K	-	1K, 2K	Opløsning
image_size	select	Nej	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Billedstørrelse
output_format	select	Nej	png	-	png, jpeg	Outputformat
prompt_extend	select	Nej	true	-	true, false	Lad modellen omskrive en enkel positiv prompt før generering, eller slå funktionen fra for at styre formuleringen strammere.
nsfw_checker	select	Nej	false	-	false, true	Aktivér modellens valgfrie indholdsfilter. Intet automatisk filter kan garantere fuldstændig dækning.
negative_prompt	text	Nej	-	-	-	Negativ prompt
seed	number	Nej	1	min 0 / max 2147483647 / step 1	-	Lad feltet stå tomt for et nyt tilfældigt resultat hver gang. Genbrug af det samme heltal gør det lettere at reproducere eller finjustere et tidligere resultat. Det holder sig kun tættere på, når prompten og andre vigtige indstillinger også forbliver nogenlunde ens, og det garanterer ikke et 1:1-match.

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Referencebilleder: Upload op til tre billeder i JPEG, PNG, WebP, BMP, GIF eller TIFF på højst 10 MB hver.

Maks. filer

Accepterede filtyper

image

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kind	Maks. størrelse	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Minimal anmodning

{
  "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": "Valgfrie elementer eller fejltyper, der skal undgås, op til 5.000 tegn.",
    "seed": 1
  }
}

Referencefilanmodning

{
  "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": "Valgfrie elementer eller fejltyper, der skal undgås, op til 5.000 tegn.",
    "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"
      }
    ]
  }
}

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

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

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.

Qwen Image 3.0 API-integration