Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
aspect_ratio | Non | La forme du cadre : large, carrée ou verticale. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · Par défaut: 1:1 |
enable_prompt_expansion | Non | Laisse le modèle enrichir un prompt court. Par défaut: true |
image_urls | Oui | Les photos à retoucher ou combiner. Dites dans le prompt ce que chacune apporte. |
negative_prompt | Non | Ce que vous ne voulez pas voir. |
num_outputs | Non | Combien de résultats en une fois. ≥ 1 · ≤ 1 · Par défaut: 1 |
prompt | Oui | Describe the subject, composition, lighting, and any text to render. |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 1k · 2k · Par défaut: 2k |
seed | Non | Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647 |
Tarifs
Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.
| Option | Crédits par image | ≈ USD |
|---|---|---|
| resolution 1K | 6 | 0,06 $US |
| resolution 2K | 11,25 | 0,11 $US |
Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.
Démarrage rapide de l'API
Appeler l’API Qwen Image 3.0 Pro en trois étapes
- Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model alibaba/qwen-image-3.0-pro/edit et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "2k",
"num_outputs": 1
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.
Questions sur l’API Qwen Image 3.0 Pro
Combien coûte l’API Qwen Image 3.0 Pro ?
Qwen Image 3.0 Pro coûte à partir de 6 crédits (0,06 $US) par image avec Modifier une image, sa tâche la moins chère. Prix par option : 1K 6 crédits par image, 2K 11,25 crédits par image. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.
Quel est le nom de modèle de Qwen Image 3.0 Pro dans l’API ?
Indiquez alibaba/qwen-image-3.0-pro/text-to-image pour Créer une image; alibaba/qwen-image-3.0-pro/edit pour Modifier une image dans le champ model de POST /jobs/createTask.
En quoi Qwen Image 3.0 Pro diffère-t-il de Qwen Image 3.0 ?
Même forme de requête, mêmes champs, plafond de détail plus haut — surtout visible sur la typographie à plusieurs éléments et sur les matières fines. Explorez sur 3.0, livrez sur Pro ; le prompt n’a pas besoin d’être réécrit entre les deux.
Combien d’éléments de texte une couverture peut-elle porter ?
Trois ou quatre chaînes courtes constituent la plage fiable : un titre, une ligne de numéro et une ou deux accroches. Citez chacune séparément et dites où elle se place. Les paragraphes entiers s’effondrent encore.
Quel ratio d’image utiliser pour une couverture ?
Le 3:4 ou le 2:3. Tous deux sont composés pour cette forme dès le départ, ce qui n’est pas la même chose que recadrer un carré — le sujet et la typo sont disposés pour le cadre demandé.
Puis-je retoucher une couverture existante plutôt que la régénérer ?
Oui, sur le point de terminaison image-to-image. Passez l’image dans image_urls, citez l’ancienne et la nouvelle formulation, et nommez tout ce qui doit rester identique — pose, cadrage, étalonnage.
Puis-je obtenir plusieurs variantes d’une même mise en page ?
Pas en un seul appel : num_outputs est fixé à 1. Envoyez le même brief en requêtes parallèles sans seed. Chacune rend une image et se chiffre séparément, et comme seul le tirage diffère, les lectures restent directement comparables.
Quelles sont les limites de l’API Qwen Image 3.0 Pro ?
Résolutions: 1K · 2K; Formats d’image: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; Images de référence: 3; Longueur du prompt (caractères): 5,000; Taille maximale d’envoi: 10 MB. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Qwen Image 3.0 Pro sans écrire de code ?
Oui. Le Playground lance Qwen Image 3.0 Pro avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.
Tous les modèles Qwen Image
Qwen Image 3.0 accepte exactement les mêmes prompts pour un peu moins cher et c'est l'endroit où explorer. Pro a le plafond le plus haut sur la typographie et les matières fines.
- API Qwen Image 2.1 ProJusqu’à six images 2K détaillées à partir d’un seul promptÀ partir de 6 crédits par image
- API Qwen Image 2.1 TurboRendus rapides en 8 étapes, jusqu’à six par promptÀ partir de 3 crédits par image
- API Qwen Image 2.1Modèle ouvert avec sortie 2K et fonds transparentsÀ partir de 4 crédits par image
- API Qwen Image 2.1 LoRAImages et retouches Qwen Image 2.1 avec jusqu’à trois de tes LoRAÀ partir de 5 crédits par image
- API Qwen Image 3.0 ProTypographie fine, peau, tissu et verre plus vrais que natureÀ partir de 6 crédits par image
- API Qwen Image 3.0Enseignes et titres lisibles intégrés à l’imageÀ partir de 5 crédits par image
- API Qwen Image 2Du texte à l’image et des retouches sur une seule photo, tout simplementÀ partir de 6 crédits par image
- API Qwen Image 2512 LoRARendus et retouches Qwen Image 2512 avec tes propres LoRAÀ partir de 5 crédits par image
- API Qwen Image Edit 2509 LoRARetouches Qwen multi-photos qui chargent tes propres LoRAÀ partir de 5 crédits par image
- API Qwen Image 1.0 LoRALe Qwen-Image d’origine, lettrage net et tes propres LoRAÀ partir de 5 crédits par image

