Modifier une image

Vue d’ensembleCopy Anchor Link

Crée une image modifiée ou prolongée à partir d’une image originale et d’un prompt.

Cet endpoint prend en charge à la fois :

• le flux de téléversement multipart/form-data compatible OpenAI documenté ci-dessous
• les requêtes JSON qui fournissent image_url, image_urls ou des références officielles images pour les familles image-to-image prises en charge

Corps de la requêteCopy Anchor Link

Timeout des requêtes synchrones : certaines requêtes image renvoient l’image finale inline et attendent la fin de la génération. Les requêtes haute résolution ou haute qualité peuvent prendre près d’une minute ou plus ; définissez donc le timeout de votre client HTTP à au moins 120s. Si la réponse de création inclut status: "pending", task_id ou poll_url, suivez plutôt le poll_url renvoyé.

URLs d’image distantes : lorsqu’une entrée multipart est nécessaire, TokenLab récupère JSON image_url, image_urls ou images[].image_url et envoie les octets comme parties multipart image. Les URLs doivent être publiques en http/https, sans identifiants intégrés ni fragments, et ne doivent pas résoudre vers localhost, des plages IP privées ou réservées ; chaque redirection est revérifiée. Le contenu récupéré doit être une vraie image PNG, JPEG ou WebP. Limites : 50 MiB par image, 200 MiB au total pour les images récupérées par URL dans une requête, timeout de récupération 30s et jusqu’à 3 redirections.

Une requête JSON doit fournir exactement un champ parmi image_url, image_urls et images. Chaque objet images[] doit contenir soit image_url, soit file_id, jamais les deux. La limite totale de 200 MiB inclut toutes les images sources et le masque.

RéponseCopy Anchor Link

Réponse de tâche asynchroneCopy Anchor Link

Définissez async: true avec gpt-image-2 ou les modèles d’édition officiels FLUX/BFL pour créer une tâche au lieu d’attendre l’image modifiée dans la requête. La réponse contient status: "pending", task_id et poll_url. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche passe à completed ou failed.

Les tâches d’édition asynchrones ne renvoient que les URL finales. Si vous avez besoin des données image brutes b64_json, utilisez une requête synchrone.

La création de la tâche peut réserver le montant estimé. Les tâches terminées sont facturées selon l’usage réel ; les tâches échouées ou expirées libèrent ou remboursent la réserve.

curl -X POST "https://api.tokenlab.sh/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=gpt-image-2" \
  -F "image=@sunlit_lounge.png" \
  -F "mask=@mask.png" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

NotesCopy Anchor Link

{
  "model": "hy-image-v3.5-preview",
  "prompt": "Change the table to pale blue",
  "image_url": "https://example.com/reference.png",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}