Intégration de l'API Qwen Image 3.0 Pro : curl, Python et tous les paramètres

Qwen Image 3.0 Pro (Tongyi Qianwen Image 3.0 Pro) dispose de deux points d'entrée sur HiAPI : texte-vers-image qwen-image-3.0-pro/text-to-image et image-vers-image qwen-image-3.0-pro/image-to-image. Il coûte plus cher que la version standard, en échange de détails et de textures plus riches, tout en écrivant toujours avec précision le texte en chinois et en anglais. Cet article fournit des exemples curl et Python directement exécutables, la totalité des paramètres actuels, ainsi que quelques points à surveiller avant la mise en production.

Les anciens noms de modèles qwen-image-3.0-pro et le champ size ne sont plus utilisables : les anciens noms de modèles renvoient MODEL_UNAVAILABLE, et size est rejeté comme champ inconnu. Veuillez utiliser les deux noms de modèles ci-dessus, avec aspect_ratio et resolution.

Parlons d'abord du prix

	1K (par défaut)	2K
Pro texte-vers-image / image-vers-image	$0.0497	$0.0993
Version standard texte-vers-image / image-vers-image (référence)	$0.0358	$0.0358

Prix actuels HiAPI, vérifiés le 18 octobre 2026.

Pro en 1K coûte environ 39 % de plus que la version standard, et 2K environ 2,8 fois le prix de la version standard. Les 1 à 3 images de référence pour l'image-vers-image ne coûtent rien de plus. Aucun frais n'est facturé en cas d'échec.

Une image réellement générée

Format 16:9. Sur la plaque de cuivre posée sur la table, « 深海来信 » et la petite ligne en dessous « LETTERS FROM THE DEEP » sont toutes deux écrites correctement, mot pour mot :

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

Générer avec ce prompt →

qwen-image-3.0-pro/text-to-image, 16:9, image d'exemple de la page du modèle.

Réussir sa première génération

Préparation : créez une clé API dans la console. Les nouveaux utilisateurs reçoivent 200 crédits à l'inscription.

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
    }
  }'

Après avoir reçu le taskId, consultez le résultat :

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

Lorsque data.status vaut success, l'image se trouve dans data.output[0].url. Il s'agit d'un lien temporaire : téléchargez-la et archivez-la dès que vous l'obtenez.

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)

Tous les paramètres

Champ	Obligatoire	Valeur	Description
prompt	Oui	18000 caractères maximum	Contenu de l'image, style, composition ; placez entre guillemets les mots à faire apparaître
image_urls	Obligatoire pour l'image-vers-image	1 à 3 images	JPEG/PNG/WEBP/BMP/GIF/TIFF, ≤10MB par image, SVG non pris en charge
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	Détermine le prix
output_format	Non	png (par défaut) / jpeg
prompt_extend	Non	Booléen, par défaut true	Réécrit automatiquement le prompt ; réglez sur false lorsque le texte doit être reproduit à l'identique
negative_prompt	Non	500 caractères maximum	Contenu à ne pas faire apparaître
seed	Non	0–2147483647	Fixez-le pour faciliter la reproduction

Exemple image-vers-image :

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

Erreurs courantes

Toutes sont renvoyées de manière synchrone en HTTP 400 à la soumission, sans création de tâche ni facturation :

• MODEL_UNAVAILABLE : vous avez utilisé l'ancien nom de modèle qwen-image-3.0-pro, remplacez-le par le nom avec /text-to-image ou /image-to-image.
• additional properties 'size' not allowed : size n'est plus accepté, utilisez aspect_ratio avec resolution.
• resolution: value must be one of '1K', '2K' : Pro ne propose pas la 4K.
• image_urls: minItems: got 0, want 1 : l'image-vers-image nécessite au moins 1 image de référence.

À surveiller avant la mise en production

• Désactivez prompt_extend lors de l'écriture de texte : la réécriture automatique peut modifier les mots que vous souhaitez.
• Utilisez un callback plutôt que le polling : ajoutez au niveau supérieur du corps de la requête "callback": {"url": "https://votre-domaine/hiapi/callback", "when": "final"}, et dédupliquez par taskId.
• Évitez la double facturation : ajoutez l'en-tête Idempotency-Key à la soumission et réutilisez la même clé en cas de nouvelle tentative après un délai d'attente.
• Archivez rapidement : les liens de sortie expirent.

Questions fréquentes

Faut-il choisir Pro ou la version standard ?

Commencez par la version standard, à $0.0358 l'image, au même prix en 1K et en 2K. Passez à Pro lorsque les détails de la version standard ne suffisent pas. Pour l'intégration de la version standard, voir Intégration de l'API Qwen Image 3.0.

Peut-on générer en 4K ?

Non, uniquement en 1K et 2K.

Combien d'images de référence au maximum ?

3 images, sans surcoût.

Vous pouvez aussi copier directement le prompt du restaurant sous-marin ci-dessus et générer directement depuis la page du modèle.