Documentation Qwen API
Référence concise pour l'authentification, la génération Qwen Image, les tâches asynchrones, les ID de modèles et les erreurs.
Démarrage rapide
L'API utilise du JSON standard via HTTPS. Créez une clé, envoyez une génération et interrogez l'ID de tâche.
- 01
Créer une clé Bearer
- 02
Envoyer une génération
- 03
Interroger l'ID de tâche
URL de base
Toutes les requêtes API publiques utilisent le domaine qwenapi.org.
https://qwenapi.orgAuthentification
Envoyez votre clé Qwen API dans l'en-tête Authorization pour chaque requête de génération, statut et historique.
Authorization: Bearer $QWEN_API_KEY
Conservez les clés API sur votre serveur. Ne les exposez pas dans les bundles navigateur, dépôts publics ou logs clients.
Générer une image
Envoyez un ID de modèle actif et ses champs d'entrée documentés.
curl https://qwenapi.org/api/v1/images/generations \
-H "Authorization: Bearer $QWEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-3",
"prompt": "Editorial product photo in soft morning light",
"aspect_ratio": "16:9",
"resolution": "1K"
}'Réponse d'acceptation
{
"code": 200,
"message": "success",
"data": {
"task_id": "n86...qw3",
"status": "IN_PROGRESS"
}
}Obtenir le statut
Utilisez l'ID de tâche pour obtenir la progression, les erreurs et les URL de sortie finales.
curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \ -H "Authorization: Bearer $QWEN_API_KEY"
IN_PROGRESS
Le backend a accepté la tâche et travaille.
SUCCESS
Les URL de sortie sont prêtes.
FAILED
La tâche s'est arrêtée avec une erreur structurée.
ID des modèles actifs
Seuls ces ID pointent actuellement vers des routes de production avec facturation.
| Modèle | Coût | Entrée | Sortie |
|---|---|---|---|
| qwen-image-3 | 10 credits / image | Text, up to 3 images | PNG or JPEG |
| qwen2-image | 10 credits / image | Text or image | PNG or JPEG |
| qwen-image-2512 | 5 credits / image | Text or images | PNG, JPEG, WebP |
| qwen-multi-angles | 5 credits / image | 1-3 images | PNG or JPEG |
| qwen-layered | 10 credits / layer | Image and instruction | Layer images |
Erreurs
Les codes HTTP sont associés à des erreurs JSON structurées. Conservez l'ID de tâche pour le support.
400invalid_requestVérifiez l'ID du modèle et les champs de la requête.401unauthorizedVérifiez que la clé Bearer est présente et active.402insufficient_creditsAjoutez des crédits dans le tableau de facturation.404not_foundVérifiez que l'ID de tâche appartient à une route Qwen.429rate_limitedRéessayez avec temporisation et jitter.500server_errorRéessayez plus tard et conservez l'ID pour le support.