Använd Qwen Image 3.0 via Rivyas publika API v1 med modell-ID qwen-image-3, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIText eller URL klar; referenslägen använder Files APIBild

API-modell-ID

qwen-image-3

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

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

Förmåga

Bild

Fakturering

FIXED

Promptgräns

800 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

Nyckel	Typ	Obligatoriskt	Standard	Beskrivning
model	string	Ja	qwen-image-3	Använd API-modell-ID:t qwen-image-3.
prompt	string	Ja	-	Högst 800 tecken för den här modellen.
params	object	Ja	-	Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_id	string	Nej	-	Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

Nyckel	Typ	Obligatoriskt	Standard	Intervall	Alternativ	Beskrivning
resolution	select	Ja	1K	-	1K, 2K	Upplösning
image_size	select	Nej	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Bildstorlek
output_format	select	Nej	png	-	png, jpeg	Utdataformat
prompt_extend	select	Nej	true	-	true, false	Låt modellen skriva om en enkel positiv prompt före genereringen, eller stäng av funktionen för striktare kontroll över formuleringen.
nsfw_checker	select	Nej	false	-	false, true	Aktivera modellens valfria innehållsfilter. Inget automatiskt filter kan garantera fullständig täckning.
negative_prompt	text	Nej	-	-	-	Negativ prompt
seed	number	Nej	1	min 0 / max 2147483647 / step 1	-	Lämna fältet tomt för ett nytt slumpmässigt resultat varje gång. Om du återanvänder samma heltal blir det enklare att återskapa eller finjustera ett tidigare resultat. Det blir bara mer likt när prompten och andra viktiga inställningar också förblir liknande, och en identisk 1:1-matchning garanteras inte.

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Referensbilder: Ladda upp upp till tre bilder i JPEG, PNG, WebP, BMP, GIF eller TIFF, högst 10 MB per bild.

Max filer

Godkända filtyper

image

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kind	Max storlek	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Minimal begäran

{
  "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": "Valfria element eller feltyper att undvika, upp till 5,000 tecken.",
    "seed": 1
  }
}

Begäran med referensfil

{
  "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": "Valfria element eller feltyper att undvika, upp till 5,000 tecken.",
    "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"
      }
    ]
  }
}

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.

Qwen Image 3.0 API-integration