Rappel à la fin de la tâche (Webhook)

​

Démarrage rapide

curl -X POST https://votre-domaine-d-acces/v1/images/generations \
  -H "Authorization: Bearer VOTRE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a red apple on a table",
    "size": "1024x1024",
    "webhook": "https://your-server.com",
    "language": "fr"
  }'

​

Choisir la langue du message d’erreur

• Les valeurs ne sont pas sensibles à la casse et les espaces en début et fin sont automatiquement supprimés. Par exemple, "FR" et " fr " sont tous deux traités comme fr.
• Utilisez les codes à deux lettres du tableau. Les balises régionales telles que zh-CN, en-US et pt-BR ne sont pas reconnues.
• Une valeur non prise en charge ne fait pas échouer la soumission de la tâche ; le rappel conserve le message d’erreur d’origine.
• Si le message d’origine est déjà dans la langue cible, il est renvoyé tel quel sans nouvelle traduction.
• Si la traduction échoue, le message d’origine est renvoyé sans retarder ni abandonner le rappel.

​

Règles d’URL

​

Ce que vous allez recevoir

{
  "id": "task_01KV7FXR8BEYS1BWHJCT3JMCJ5",
  "status": "completed",
  "progress": 100,
  "created": 1781589029,
  "completed": 1781589058,
  "actual_time": 29,
  "cost": 0.006,
  "credits_cost": 0.06,
  "result": {
    "images": [{ "url": ["https://.../result.png"], "expires_at": 1781675458 }]
  }
}

{
  "id": "task_xxx",
  "status": "failed",
  "progress": 100,
  "created": 1781589029,
  "completed": 1781589050,
  "error": {
    "message": "Impossible d'accéder à l'image d'entrée. Vérifiez que l'URL est accessible publiquement",
    "type": "task_failed",
    "param": "",
    "code": "task_failed"
  }
}

​

Nouvelles tentatives et déduplication (important)

• Nouvelles tentatives : Si votre serveur ne renvoie pas 2xx en environ 10 secondes, ou renvoie 5xx, nous réessaierons automatiquement, jusqu’à 3 fois, à des intervalles d’environ 10 s, 30 s et 60 s. Si les 3 échouent, nous abandonnons (en environ 2 minutes).
• Pas de nouvelle tentative : Si votre point de terminaison renvoie 4xx (considéré comme une URL / requête incorrecte), nous abandonnons immédiatement sans réessayer.
• Déduplication : Normalement, une tâche n’est envoyée qu’une seule fois. Mais dans des cas extrêmes (p. ex. un redémarrage de notre côté après l’envoi mais avant la confirmation), vous pourriez recevoir des envois en double. Veillez à dédupliquer de manière idempotente par id (task_id) pour éviter un double traitement.

​

Exigences pour l’URL de rappel

​

FAQ

​

Exemple minimal de récepteur

from http.server import BaseHTTPRequestHandler, HTTPServer
import json

class H(BaseHTTPRequestHandler):
    def do_POST(self):
        n = int(self.headers.get("Content-Length") or 0)
        body = self.rfile.read(n)
        data = json.loads(body)
        print("Rappel de tâche reçu :", data["id"], data["status"])
        # TODO : dédupliquer par id, vérifier la signature, puis traiter
        self.send_response(200); self.end_headers()
        self.wfile.write(b'{"ok":true}')

HTTPServer(("0.0.0.0", 443), H).serve_forever()