Nutze Qwen Image 3.0 Pro über Rivya Public API v1 mit Model-ID qwen-image-3-pro, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarText oder URL bereit; Referenzmodi nutzen Files APIBild

API-Modell-ID

qwen-image-3-pro

Eingaben

text, file

Files API

Für Referenzmodi erforderlich

Basis-Credits

per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉

Fähigkeit

Bild

Abrechnung

FIXED

Prompt-Limit

800 Zeichen

Request-Kontrakt

Sende die Modell-ID auf Top-Level. Modellspezifische Controls gehören in params.

Key	Typ	Erforderlich	Standard	Beschreibung
model	string	Ja	qwen-image-3-pro	Verwende qwen-image-3-pro als API-Modell-ID.
prompt	string	Ja	-	Maximal 800 Zeichen für dieses Modell.
params	object	Ja	-	Modellspezifisches Parameterobjekt. Die erlaubten Keys stehen in den Zeilen darunter.
client_request_id	string	Nein	-	Optionale Client-ID, um Requests in deinem System nachzuverfolgen.

Modellparameter

Key	Typ	Erforderlich	Standard	Bereich	Optionen	Beschreibung
resolution	select	Ja	1K	-	1K, 2K	Auflösung
image_size	select	Nein	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9	Bildformat
output_format	select	Nein	png	-	png, jpeg	Ausgabeformat
prompt_extend	select	Nein	true	-	true, false	Lasse das Modell einen einfachen positiven Prompt vor der Generierung umformulieren oder deaktiviere die Funktion für eine genauere Kontrolle des Wortlauts.
nsfw_checker	select	Nein	false	-	false, true	Aktiviere den optionalen Inhaltsfilter des Modells. Kein automatischer Filter kann eine vollständige Abdeckung garantieren.
negative_prompt	text	Nein	-	-	-	Negativ-Prompt
seed	number	Nein	1	min 0 / max 2147483647 / step 1	-	Lass das Feld leer, um jedes Mal ein neues zufälliges Ergebnis zu erhalten. Wenn du dieselbe Ganzzahl erneut verwendest, lässt sich ein früheres Ergebnis leichter reproduzieren oder feinabstimmen. Es bleibt nur dann näher am Original, wenn Prompt und andere wichtige Einstellungen ebenfalls ähnlich bleiben, und es ist keine garantierte 1:1-Übereinstimmung.

Upload-Richtlinie

Lade zuerst Referenzdateien hoch und setze dann die zurückgegebene URL und den durationToken in params.referenceMediaItems.

Referenzregel

Referenzbilder: Lade bis zu drei Bilder als JPEG, PNG, WebP, BMP, GIF oder TIFF mit jeweils höchstens 10 MB hoch.

Max. Dateien

Akzeptierte Dateitypen

image

Duration Token

Video- und Audioreferenzen sollten durationToken aus /api/v1/files mitführen, wenn eine Dauerprüfung erforderlich ist.

kind	Max. Größe	MIME-Typen
image	10 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff

Minimalrequest

{
  "model": "qwen-image-3-pro",
  "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": "Optional: zu vermeidende Elemente oder Fehlerbilder, bis zu 5.000 Zeichen.",
    "seed": 1
  }
}

Request mit Referenzdatei

{
  "model": "qwen-image-3-pro",
  "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": "Optional: zu vermeidende Elemente oder Fehlerbilder, bis zu 5.000 Zeichen.",
    "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

Der Create-Endpunkt gibt eine öffentliche Task-ID zurück. Frage den Status-Endpunkt ab, bis der Task erfolgreich ist oder fehlschlägt.

{
  "id": "task_qwen_image_3_pro_example",
  "status": "queued",
  "model": "qwen-image-3-pro",
  "reserved_credits": 7,
  "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
}

Häufige Fehler

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Einige Modi benötigen Referenz-Uploads über Files API.

Qwen Image 3.0 Pro API-Integration