Ressources pour les développeurs

Documentation de l'API Qwen-Image-2512

Intégrez le modèle Qwen-Image-2512 AI d'Alibaba dans vos applications. Générez des images de haute qualité à partir de descriptions textuelles via une API REST simple.

Authentification

L'API Qwen-Image-2512 utilise l'authentification par Bearer Token. Passez votre clé API dans l'en-tête de la requête.

Authentification

Authorization: Bearer sk-your-api-key-here

Gardez votre clé API en sécurité. Ne la partagez pas dans le code côté client.

Tarification

Type	Coût	Description
Texte vers image	5 Crédits	Générez des images à partir de descriptions textuelles avec Qwen-Image-2512 AI.

Créer une tâche

POSThttps://qwen-image-2512.org/api/generate

Génération asynchrone

Tarification

Chaque génération d'image coûte 5 crédits.

Lancez une tâche de génération. L'API renvoie immédiatement un task_id, que vous utilisez pour consulter le résultat.

Paramètres du corps

Paramètre	Type	Requis	Description
prompt	string	Requis	La description textuelle pour la génération d'image. Max 2000 caractères.
size	string	Optionnel	Taille de l'image. Supporté: 10241024, 10241536, 15361024, 7681024, 1024768. Par défaut: 10241024
seed	number	Optionnel	Graine aléatoire pour des résultats reproductibles. -1 pour aléatoire. Par défaut: -1
output_format	string	Optionnel	Format de sortie: jpeg, png ou webp. Par défaut: jpeg
callback_url	string	Optionnel	URL Webhook pour la notification de fin de tâche.

Exemples de requêtes

Exemple texte vers image (cURL)

curl -X POST https://qwen-image-2512.org/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset",
    "size": "1024*1024",
    "output_format": "png"
  }'

Réponse de succès

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS"
  }
}

Réponse d'erreur

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Vérifier le statut

GEThttps://qwen-image-2512.org/api/status

Interrogez ce point de terminaison pour vérifier la progression de votre tâche. Nous recommandons une interrogation toutes les 5-10 secondes.

Paramètres de requête

Paramètre	Type	Description
task_id	string	L'ID de tâche reçu du point de terminaison de génération. Requis

Valeurs de statut

PENDINGTâche en file d'attente

IN_PROGRESSTraitement en cours

SUCCESSTerminé

FAILEDUne erreur est survenue

cURL

curl -X GET "https://qwen-image-2512.org/api/status?task_id=n43abc123def456qwenimg" \
  -H "Authorization: Bearer YOUR_API_KEY"

Réponse (En cours)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Réponse (Terminée)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "SUCCESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": ["https://cdn.example.com/image.png"]
  }
}

Réponse (Échec)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Codes d'erreur

Code	Description
200	Succès
400	Mauvaise requête - Paramètres invalides (prompt manquant, taille invalide, etc.)
401	Non autorisé - Clé API manquante ou invalide
404	Non trouvé - L'ID de tâche n'existe pas
500	Erreur interne du serveur - Veuillez réessayer ou contacter le support

Besoin d'aide ?

Consultez notre canal de support ou contactez-nous par e-mail.

Contacter le support