Ressources pour les développeurs
Documentation de l'API GPT Image 1.5
Intégrez le modèle GPT Image 1.5 d'OpenAI dans vos applications. Prise en charge de la génération texte-vers-image et image-vers-image via une API REST simple.
1
Authentification
L'API GPT Image 1.5 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 | 10 Crédits | Générez des images à partir de descriptions textuelles (prompts). |
| Image vers image | 10 Crédits | Modifiez des images existantes à partir de descriptions textuelles. |
2
Créer une tâche
POST
https://gptimage15.ai/api/generateGénération asynchrone
Tarification
Chaque demande de génération coûte 10 Credits, qu'il s'agisse de texte-vers-image ou d'image-vers-image.
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 : 1024*1024, 1024*1536, ou 1536*1024. Par défaut : 1024*1024 |
| quality | string | Optionnel | Qualité de l'image : low, medium, ou high. Par défaut : medium |
| images | array | Optionnel | Pour le mode Image-vers-Image. Tableau d'URLs d'images à modifier. |
| input_fidelity | string | Optionnel | Fidélité à l'image d'entrée : low ou high. Par défaut : high. Uniquement pour l'image-vers-image. |
| callback_url | string | Optionnel | URL Webhook pour la notification de fin de tâche. |
Exemples de requêtes
Text-to-Image (cURL)
curl -X POST https://gptimage15.ai/api/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A serene mountain landscape...",
"size": "1536*1024",
"quality": "high"
}'Image-to-Image (Edit Mode)
{
"prompt": "Add a rainbow in the sky",
"images": [
"https://example.com/landscape.jpg"
],
"input_fidelity": "high",
"quality": "medium"
}Réponse de succès
{
"code": 200,
"data": {
"task_id": "n36abc123def456gptimg",
"status": "IN_PROGRESS"
}
}Réponse d'erreur
{
"code": 400,
"message": "Bad Request: 'prompt' is required.",
"data": null
}3
Vérifier le statut
GET
https://gptimage15.ai/api/statusInterrogez 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'attenteIN_PROGRESSTraitement en coursSUCCESSTerminéFAILEDUne erreur est survenuecURL
curl -X GET "https://gptimage15.ai/api/status?task_id=n36abc123def456gptimg" \
-H "Authorization: Bearer YOUR_API_KEY"Réponse (En cours)
{
"code": 200,
"data": {
"task_id": "n36abc123def456gptimg",
"status": "IN_PROGRESS",
"consumed_credits": 10,
"created_at": "2024-12-19T10:00:00Z"
}
}Réponse (Terminée)
{
"code": 200,
"data": {
"task_id": "n36abc123def456gptimg",
"status": "SUCCESS",
"response": [
"https://cdn.example.com/image.png"
]
}
}Réponse (Échec)
{
"code": 200,
"message": "success",
"data": {
"task_id": "n36abc123def456gptimg",
"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/qualité 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 |