Référence API de Qwen Image 3.0 Pro
Typographie fine, peau, tissu et verre plus vrais que nature
Une seule clé API PopNow suffit pour appeler Qwen Image 3.0 Pro depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.
Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.
En bref
- Éditeur
- Alibaba
- Résultat
- Image
- À partir de
- 6 crédits par image ($0.06)
- Durée habituelle
- environ 36 s
- Identifiants de modèle
1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.
Créer une image
alibaba/qwen-image-3.0-pro/text-to-image
Prix
| Option | Crédits (par image) | Dollars US |
|---|---|---|
1k | 6 | $0.06 |
2k | 11.25 | $0.1125 |
Paramètres
| Champ | Type | Valeur par défaut | Valeurs admises | Rôle |
|---|---|---|---|---|
promptObligatoire | string | — | jusqu’à 5 000 caractères | Describe the subject, composition, lighting, and any text to render. |
aspect_ratioFacultatif | string | 1:1 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 | Output aspect ratio. |
resolutionFacultatif | string | 2k | 1k, 2k | Output image resolution tier. |
num_outputsFacultatif | integer | 1 | de 1 à 1 | Number of output images. |
enable_prompt_expansionFacultatif | boolean | true | — | Let the service rewrite and expand the prompt before generation. |
negative_promptFacultatif | string | — | jusqu’à 2 000 caractères | Describe elements to exclude from the image. |
prompt_optimization_modeFacultatif | string | direct | direct, agent | How prompt expansion rewrites the brief: single pass, or a multi-step agent rewrite. |
seedFacultatif | integer | — | de 0 à 2147483647 | Random seed for controlled comparisons. |
Exemple de requête
Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/text-to-image",
"input": {
"prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
"num_outputs": 1,
"resolution": "2k"
}
}'La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Modifier une image
alibaba/qwen-image-3.0-pro/edit
Prix
| Option | Crédits (par image) | Dollars US |
|---|---|---|
1k | 6 | $0.06 |
2k | 11.25 | $0.1125 |
Paramètres
| Champ | Type | Valeur par défaut | Valeurs admises | Rôle |
|---|---|---|---|---|
promptObligatoire | string | — | jusqu’à 5 000 caractères | Describe the subject, composition, lighting, and any text to render. |
image_urlsObligatoire | array<string (uri)> | — | jusqu’à 3 éléments | Reference images in the order used by the editing instruction. |
aspect_ratioFacultatif | string | 1:1 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 | Output aspect ratio. |
resolutionFacultatif | string | 2k | 1k, 2k | Output image resolution tier. |
num_outputsFacultatif | integer | 1 | de 1 à 1 | Number of output images. |
enable_prompt_expansionFacultatif | boolean | true | — | Let the service rewrite and expand the prompt before generation. |
negative_promptFacultatif | string | — | jusqu’à 2 000 caractères | Describe elements to exclude from the image. |
seedFacultatif | integer | — | de 0 à 2147483647 | Random seed for controlled comparisons. |
Exemple de requête
Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.
L’exemple utilise des fichiers d’exemple PopNow dans image_urls. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.
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: $(uuidgen)" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/edit",
"input": {
"prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"num_outputs": 1,
"resolution": "2k"
}
}'La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"