Qwen Image 3.0 Pro API-Zugang: curl, Python und alle Parameter

Qwen Image 3.0 Pro (Tongyi Qianwen Image 3.0 Pro) hat bei HiAPI zwei Endpunkte: Text-zu-Bild qwen-image-3.0-pro/text-to-image und Bild-zu-Bild qwen-image-3.0-pro/image-to-image. Es ist teurer als die Standardversion, liefert dafür aber reichhaltigere Details und Materialien und schreibt chinesische und englische Texte weiterhin präzise. Dieser Artikel enthält direkt ausführbare curl- und Python-Beispiele, alle aktuellen Parameter und einige Punkte, die vor dem Go-live zu beachten sind.

Die früheren Modellnamen qwen-image-3.0-pro und das Feld size funktionieren nicht mehr: Alte Modellnamen geben MODEL_UNAVAILABLE zurück, size wird als unbekanntes Feld abgelehnt. Verwenden Sie die beiden oben genannten Modellnamen zusammen mit aspect_ratio und resolution.

Zuerst die Preise

	1K (Standard)	2K
Pro Text-zu-Bild / Bild-zu-Bild	$0.0497	$0.0993
Standardversion Text-zu-Bild / Bild-zu-Bild (zum Vergleich)	$0.0358	$0.0358

HiAPI-Aktuellpreis, geprüft am 18. Oktober 2026.

Pro 1K ist etwa 39 % teurer als die Standardversion, 2K kostet etwa das 2,8-Fache der Standardversion. 1–3 Referenzbilder bei Bild-zu-Bild kosten nichts extra. Bei Fehlschlägen wird nichts berechnet.

Ein echtes generiertes Bild

16:9. Die Worte „深海来信“ auf der Messingtafel am Tisch und die kleine Zeile darunter „LETTERS FROM THE DEEP“ sind beide zeichengenau korrekt geschrieben:

High-end cinematic architectural editorial photograph inside a futuristic underwater restaurant at midnight. A vast curved observation window fills the background with deep cobalt water and luminous translucent jellyfish drifting outside. On the right, a sculptural dining table of black stone, hand-blown glass and restrained brushed brass catches a narrow beam of warm light. A small refined brass menu plaque on the table is naturally photographed and contains only the exact Chinese characters “深海来信”; directly below, the exact English words “LETTERS FROM THE DEEP”. The left third remains calm dark-blue negative space with volumetric light rays. No poster layout; this must feel like an expensive real location photographed for an architecture magazine. cinematic composition, dramatic directional lighting, rich cohesive cobalt-and-gold color grade, ultra-detailed, premium commercial finish, subtle film grain, shallow depth of field, high dynamic range, 16:9 hero composition

Mit diesem Prompt generieren →

qwen-image-3.0-pro/text-to-image, 16:9, Beispielbild der Modellseite.

Das erste Bild zum Laufen bringen

Vorbereitung: Erstellen Sie einen API Key in der Konsole. Neue Nutzer erhalten bei der Registrierung 200 Credits.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
      "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
      "aspect_ratio": "4:3",
      "resolution": "1K",
      "prompt_extend": false
    }
  }'

Nach der Rückgabe der taskId das Ergebnis abfragen:

curl -s https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Wenn data.status success ist, befindet sich das Bild unter data.output[0].url. Das ist ein temporärer Link; laden Sie das Bild sofort herunter und speichern Sie es.

Python

import os, time, requests

KEY = os.environ["HIAPI_KEY"]
BASE = "https://api.hiapi.ai/v1"
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

r = requests.post(f"{BASE}/tasks", headers=H, json={
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
        "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
        "aspect_ratio": "4:3",
        "resolution": "1K",
        "prompt_extend": False,
    },
})
task_id = r.json()["data"]["taskId"]

while True:
    d = requests.get(f"{BASE}/tasks/{task_id}", headers=H).json()["data"]
    if d["status"] in ("success", "fail"):
        break
    time.sleep(5)

if d["status"] == "success":
    open("result.png", "wb").write(requests.get(d["output"][0]["url"]).content)
else:
    print(d)

Alle Parameter

Feld	Erforderlich	Werte	Beschreibung
prompt	Ja	max. 18000 Zeichen	Bildinhalt, Stil, Komposition; gewünschten Text in Anführungszeichen angeben
image_urls	Bei Bild-zu-Bild erforderlich	1–3 Bilder	JPEG/PNG/WEBP/BMP/GIF/TIFF, einzeln ≤10MB, SVG nicht unterstützt
aspect_ratio	Nein	1:1 (Standard), 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
resolution	Nein	1K (Standard) / 2K	Bestimmt den Preis
output_format	Nein	png (Standard) / jpeg
prompt_extend	Nein	Boolean, Standard true	Schreibt den Prompt automatisch um; auf false setzen, wenn Text zeichengenau sein muss
negative_prompt	Nein	max. 500 Zeichen	Inhalte, die nicht erscheinen sollen
seed	Nein	0–2147483647	Festlegen für einfache Reproduzierbarkeit

Beispiel für Bild-zu-Bild:

{
  "model": "qwen-image-3.0-pro/image-to-image",
  "input": {
    "prompt": "把这张产品图修成高端杂志风格，保留瓶身形状和标签上的文字",
    "image_urls": ["https://example.com/product.jpg"],
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "prompt_extend": false
  }
}

Häufige Fehler

Alle werden beim Absenden synchron als HTTP 400 zurückgegeben, es wird kein Task erstellt und nichts berechnet:

• MODEL_UNAVAILABLE: Alter Modellname qwen-image-3.0-pro verwendet, ändern Sie ihn auf einen Namen mit /text-to-image oder /image-to-image.
• additional properties 'size' not allowed: size wird nicht mehr akzeptiert, verwenden Sie aspect_ratio und resolution.
• resolution: value must be one of '1K', '2K': Pro hat kein 4K.
• image_urls: minItems: got 0, want 1: Bei Bild-zu-Bild mindestens 1 Referenzbild übergeben.

Vor dem Go-live beachten

• prompt_extend beim Schreiben von Text deaktivieren: Automatisches Umschreiben kann die gewünschten Zeichen verändern.
• Callbacks statt Polling verwenden: Fügen Sie auf oberster Ebene des Request-Bodys "callback": {"url": "https://ihre-domain/hiapi/callback", "when": "final"} hinzu und deduplizieren Sie anhand der taskId.
• Doppelte Abrechnung vermeiden: Senden Sie beim Absenden den Header Idempotency-Key und verwenden Sie bei Timeout-Wiederholungen denselben Key.
• Rechtzeitig speichern: Ausgabelinks laufen ab.

Häufige Fragen

Pro oder Standardversion wählen?

Testen Sie zuerst die Standardversion, $0.0358 pro Bild, 1K und 2K zum gleichen Preis. Wechseln Sie zu Pro, wenn die Details der Standardversion nicht ausreichen. Zum Zugang der Standardversion siehe Qwen Image 3.0 API-Zugang.

Geht 4K?

Nein, nur 1K und 2K.

Wie viele Referenzbilder sind maximal möglich?

3 Bilder, ohne Aufpreis.

Sie können auch direkt den oben genannten Unterwasserrestaurant-Prompt kopieren und auf der Modellseite generieren.