Comment utiliser l'API Qwen Image 3.0 ? Réussir son affiche en chinois du premier coup

TL;DR

• Qwen Image 3.0 (Tongyi Qianwen Image 3.0) dispose de 4 points d'entrée sur HiAPI : la version standard qwen-image-3.0/text-to-image, qwen-image-3.0/image-to-image, et la version Pro qwen-image-3.0-pro/text-to-image, qwen-image-3.0-pro/image-to-image. Ouvrez la page du modèle pour l'essayer en ligne.
• Version standard à prix fixe de 0,0358 $ par image (1K et 2K au même prix) ; Pro à 0,0497 $ en 1K et 0,0993 $ en 2K. La retouche et la génération sont au même prix, et 1 à 3 images de référence ne coûtent rien de plus.
• Le chinois et le texte bilingue chinois-anglais sont ses points forts. Appel : POST /v1/tasks avec prompt, aspect_ratio, resolution, puis interrogez jusqu'à success et téléchargez.

Un aperçu

Version standard, 16:9, le chinois sur l'enseigne est écrit correctement caractère par caractère :

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

Paramètres en bref

Champ	Obligatoire	Valeurs	Description
prompt	Oui	18000 caractères maximum	Écrivez mot pour mot entre guillemets le texte à faire apparaître
aspect_ratio	Non	1:1 (par défaut) 3:2 2:3 4:3 3:4 16:9 9:16 21:9
resolution	Non	1K (par défaut) / 2K	Les deux niveaux sont au même prix en standard, le 2K coûte le double en Pro
output_format	Non	png (par défaut) / jpeg
prompt_extend	Non	Booléen, true par défaut	Réécrit automatiquement le prompt ; désactivez-le quand le texte doit être précis
negative_prompt	Non	500 caractères maximum	Ce que vous ne voulez pas voir apparaître
seed	Non	0–2147483647	Le fixer facilite la reproduction
image_urls	Obligatoire pour la retouche	1–3 images	JPEG, PNG, WEBP, etc., 10 Mo maximum par image

Les paramètres sont strictement validés ; tout champ superflu renvoie une erreur 400. Attention : l'ancienne syntaxe "model": "qwen-image-3.0" avec size ne fonctionne plus et renvoie « modèle indisponible » ou additional properties 'size' not allowed ; remplacez-la par le nom de modèle ci-dessus et aspect_ratio + resolution.

curl : réussir sa première image

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": "une affiche de boisson d'automne, au centre un latte au osmanthus, en haut un grand titre écrivant mot pour mot « 秋日限定 », en dessous un sous-titre « 桂花拿铁 », beaucoup d'espace vide, lumière naturelle douce",
      "aspect_ratio": "3:4",
      "resolution": "2K",
      "prompt_extend": false
    }
  }'

La réponse contient data.taskId. Interrogez GET /v1/tasks/{taskId} ; une fois que status passe à success, téléchargez depuis output[0].url. En version standard, le 2K et le 1K sont au même prix : demandez directement du 2K.

Python : générer, puis retoucher

# 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):
    # 重试同一次提交时复用同一个 Idempotency-Key，只会扣一次费
    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)

# 文生图，标准版 2K（$0.0358）
poster = run("qwen-image-3.0/text-to-image",
             prompt="photo produit d'un coffret à thé, boîte carrée en papier kraft avec « 云雾绿茶 » écrit sur la face avant, en dessous en petits caractères « 净含量 100 克 », dessus en ardoise, éclairage zénithal doux",
             aspect_ratio="1:1", resolution="2K", prompt_extend=False)

# 改图：换成深色背景，文字不变（同样 $0.0358）
edited = run("qwen-image-3.0/image-to-image",
             prompt="garder le coffret et son texte exactement identiques, remplacer le fond par du velours vert forêt, ajouter un filet de lumière latérale",
             image_urls=[poster], aspect_ratio="1:1", resolution="2K")

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

Pour passer en Pro, changez uniquement le nom du modèle : qwen-image-3.0-pro/text-to-image ou qwen-image-3.0-pro/image-to-image, les paramètres sont identiques.

Combien ça coûte

Point d'entrée	1K	2K
Standard génération / retouche	0,0358 $	0,0358 $
Pro génération / retouche	0,0497 $	0,0993 $

Tarifs actuels de HiAPI, vérifiés le 18 octobre 2026. Aucun frais en cas d'échec.

Pour comparer les deux niveaux avec un même prompt, voir Tarifs de l'API Qwen Image 3.0.

À vérifier avant la mise en production

• Désactivez prompt_extend quand le texte doit être précis : par défaut, il réécrit votre prompt et peut modifier au passage les caractères que vous voulez.
• Écrivez le texte à faire apparaître mot pour mot entre guillemets, et ajoutez « aucun autre texte en dehors de celui ci-dessus ».
• Utilisez un callback plutôt que le polling : ajoutez au même niveau que input "callback": {"url": "https://your-app.example.com/hiapi/callback", "when": "final"}, puis dédupliquez par taskId.
• Ajoutez l'en-tête Idempotency-Key : lors d'un nouvel essai, la même clé ne crée la tâche qu'une seule fois.
• Téléchargez le résultat immédiatement : output[0].url a une durée de validité.

Questions fréquentes

Quelle différence entre la version standard et Pro ?

Les paramètres sont identiques ; Pro offre des détails d'image et une densité de mise en page plus élevés, avec environ 39 % de plus en 1K et le double en 2K. Les deux niveaux écrivent correctement le texte en chinois.

Combien d'images puis-je envoyer au maximum pour la retouche ?

1 à 3 images, dans image_urls, sans surcoût.

Pourquoi mon ancien code renvoie-t-il « model not available » ?

L'ancien nom de modèle qwen-image-3.0 a été retiré ; utilisez qwen-image-3.0/text-to-image ; le paramètre size a aussi été remplacé par aspect_ratio et resolution.

Vous pouvez aussi essayer directement une affiche en chinois sur la page du modèle.