Wie verwendet man die Qwen Image 3.0 API? Chinesische Poster auf Anhieb richtig schreiben

TL;DR

• Qwen Image 3.0 (Tongyi Qianwen Image 3.0) hat auf HiAPI 4 Endpunkte: Standardversion qwen-image-3.0/text-to-image, qwen-image-3.0/image-to-image, Pro-Version qwen-image-3.0-pro/text-to-image, qwen-image-3.0-pro/image-to-image. Modellseite öffnen und direkt online ausprobieren.
• Standardversion: Pauschalpreis pro Bild $0.0358 (1K und 2K zum gleichen Preis); Pro 1K $0.0497, 2K $0.0993. Bildbearbeitung kostet gleich viel wie Bilderzeugung, 1–3 Referenzbilder kosten nichts extra.
• Stärke sind chinesische sowie chinesisch-englische zweisprachige Texte. Aufruf: POST /v1/tasks mit prompt, aspect_ratio, resolution; nach Erreichen von success per Polling herunterladen.

Zuerst ein Beispielbild

Standardversion, 16:9, das Chinesisch auf dem Schild wird Zeichen für Zeichen korrekt geschrieben:

qwen-image-3.0/text-to-image, 16:9, $0.0358.

Parameter auf einen Blick

Feld	Pflicht	Werte	Beschreibung
prompt	Ja	max. 18000 Zeichen	Der gewünschte Text wird Zeichen für Zeichen in Anführungszeichen geschrieben
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	Bei der Standardversion kosten beide Stufen gleich viel, bei Pro kostet 2K das Doppelte
output_format	Nein	png (Standard) / jpeg
prompt_extend	Nein	Boolesch, Standard true	Schreibt den Prompt automatisch um; ausschalten, wenn Text exakt sein muss
negative_prompt	Nein	max. 500 Zeichen	Inhalte, die nicht erscheinen sollen
seed	Nein	0–2147483647	Festlegen erleichtert die Reproduzierbarkeit
image_urls	Pflicht beim Bildbearbeitungs-Endpunkt	1–3 Bilder	JPEG, PNG, WEBP usw., je max. 10 MB

Die Parameter werden streng validiert; zusätzliche Felder führen zu 400. Beachten Sie: Die alte Schreibweise "model": "qwen-image-3.0" mit size funktioniert nicht mehr und gibt „Modell nicht verfügbar“ oder additional properties 'size' not allowed zurück. Bitte auf den oben genannten Modellnamen und aspect_ratio + resolution umstellen.

curl: das erste Bild erfolgreich erzeugen

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3.0/text-to-image",
    "input": {
      "prompt": "一张秋季饮品海报，中间是一杯桂花拿铁，顶部大标题逐字写“秋日限定”，下方副标题写“桂花拿铁”，留白充足，柔和自然光",
      "aspect_ratio": "3:4",
      "resolution": "2K",
      "prompt_extend": false
    }
  }'

Die Antwort enthält data.taskId. Pollen Sie GET /v1/tasks/{taskId}; sobald status zu success wird, laden Sie von output[0].url herunter. Bei der Standardversion kosten 2K und 1K gleich viel – fordern Sie direkt 2K an.

Python: erst Bild erzeugen, dann bearbeiten

# pip install requests; export HIAPI_KEY=你的 Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def run(model, timeout_s=300, **inp):
    # Beim Retry derselben Übermittlung denselben Idempotency-Key wiederverwenden, es wird nur einmal abgerechnet
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(4)
    raise TimeoutError(task_id)

# Text zu Bild, Standardversion 2K ($0.0358)
poster = run("qwen-image-3.0/text-to-image",
             prompt="茶叶礼盒产品图，牛皮纸方盒正面写“云雾绿茶”，下方小字“净含量 100 克”，石板台面，柔和顶光",
             aspect_ratio="1:1", resolution="2K", prompt_extend=False)

# Bildbearbeitung: Hintergrund auf dunkel ändern, Text bleibt unverändert (ebenfalls $0.0358)
edited = run("qwen-image-3.0/image-to-image",
             prompt="保持礼盒和上面的文字完全不变，把背景换成深墨绿色绒布，加一缕侧光",
             image_urls=[poster], aspect_ratio="1:1", resolution="2K")

with open("tea.png", "wb") as f:
    f.write(requests.get(edited).content)

Für Pro ändern Sie nur den Modellnamen: qwen-image-3.0-pro/text-to-image oder qwen-image-3.0-pro/image-to-image, die Parameter bleiben völlig gleich.

Was kostet es

Endpunkt	1K	2K
Standardversion Text zu Bild / Bildbearbeitung	$0.0358	$0.0358
Pro Text zu Bild / Bildbearbeitung	$0.0497	$0.0993

Aktueller HiAPI-Preis, geprüft am 18. Oktober 2026. Bei Fehlschlägen wird nichts berechnet.

Ein Vergleich beider Stufen mit demselben Prompt findet sich unter Qwen Image 3.0 API Preise.

Vor dem Go-live beachten

• Bei exakten Textanforderungen prompt_extend ausschalten: Standardmäßig wird Ihr Prompt umgeschrieben und dabei möglicherweise die gewünschten Zeichen verändert.
• Den gewünschten Text Zeichen für Zeichen in Anführungszeichen schreiben und ergänzen: „Außer dem obigen Text keinen weiteren Text“.
• Callback statt Polling verwenden: Auf derselben Ebene wie input "callback": {"url": "https://your-app.example.com/hiapi/callback", "when": "final"} hinzufügen und nach taskId deduplizieren.
• Den Request-Header Idempotency-Key mitschicken: Bei Retries wird mit demselben Key nur einmal ein Task angelegt.
• Ergebnisse sofort herunterladen: output[0].url ist nur befristet gültig.

Häufige Fragen

Was ist der Unterschied zwischen Standardversion und Pro?

Die Parameter sind gleich; Pro bietet mehr Bilddetails und höhere Layoutdichte, 1K ist etwa 39 % teurer, 2K doppelt so teuer. Chinesische Texte werden in beiden Stufen präzise geschrieben.

Wie viele Bilder kann ich bei der Bildbearbeitung maximal übergeben?

1–3 Bilder in image_urls, ohne Aufpreis.

Warum gibt mein alter Code „model not available“ zurück?

Der alte Modellname qwen-image-3.0 wurde abgeschaltet; verwenden Sie qwen-image-3.0/text-to-image; auch der Parameter size wurde durch aspect_ratio und resolution ersetzt.

Sie können auch direkt auf der Modellseite ein chinesisches Poster ausprobieren.