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

TypeCoûtDescription
Texte vers image10 CréditsGénérez des images à partir de descriptions textuelles (prompts).
Image vers image10 CréditsModifiez des images existantes à partir de descriptions textuelles.
2

Créer une tâche

POSThttps://gptimage15.ai/api/generate
Gé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ètreTypeRequisDescription
promptstringRequisLa description textuelle pour la génération d'image. Max 2000 caractères.
sizestringOptionnelTaille de l'image : 1024*1024, 1024*1536, ou 1536*1024. Par défaut : 1024*1024
qualitystringOptionnelQualité de l'image : low, medium, ou high. Par défaut : medium
imagesarrayOptionnelPour le mode Image-vers-Image. Tableau d'URLs d'images à modifier.
input_fidelitystringOptionnelFidélité à l'image d'entrée : low ou high. Par défaut : high. Uniquement pour l'image-vers-image.
callback_urlstringOptionnelURL 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

GEThttps://gptimage15.ai/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ètreTypeDescription
task_idstringL'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://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

CodeDescription
200Succès
400Mauvaise requête - Paramètres invalides (prompt manquant, taille/qualité invalide, etc.)
401Non autorisé - Clé API manquante ou invalide
404Non trouvé - L'ID de tâche n'existe pas
500Erreur 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