API de génération d’images
Générez des images à partir de texte avec GPT Image 2 et l’API OpenAI compatible de BetterToken : API Key, Base URL, paramètres, Python, JavaScript et erreurs.
POST /v1/images/generations
L’endpoint texte à image utilise un corps de Request application/json. Envoyez un prompt, gardez la Request HTTP ouverte et lisez l’image générée depuis data[0].b64_json dans la même réponse.
https://bettertoken.ai/v1 comme Base URL. Passez votre BetterToken API Key via Authorization: Bearer YOUR_API_KEY.Choisir le bon parcours
- Générer une image à partir d’un texte et enregistrer le résultat : restez sur cette page. Commencez par l’exemple
curl, puis utilisez Enregistrer l’image pour décoderdata[0].b64_json. - Modifier une image existante : utilisez Image to image, qui envoie un ou plusieurs fichiers source au format
multipart/form-data. - Choisir un modèle, vérifier les paramètres et estimer le budget : consultez les Model ID et prix actuels dans le model plaza, puis utilisez Valeurs recommandées ci-dessous pour les paramètres. L’article en anglais sur la première requête GPT Image 2 donne le contexte complet de la requête et de la réponse.
Démarrage rapide avec curl
Utilisezhttps://bettertoken.ai/v1 comme Base URL et envoyez une Request à https://bettertoken.ai/v1/images/generations :
Valeurs recommandées
Envoyez explicitement ces champs dans chaque Request :n > 1.
Tailles recommandées
size représente le ratio attendu et le niveau de taille. Les pixels réellement renvoyés peuvent être mappés ou ajustés par le serveur. Utilisez les dimensions de l’image décodée plutôt que de recadrer de force la sortie à la valeur demandée.
Enregistrer l’image
Une réponse réussie suit la structure de réponse d’image OpenAI compatible :data[0].b64_json et enregistrez-le comme contenu d’image base64. La réponse peut inclure des champs supplémentaires tels que revised_prompt ; autorisez ces champs dans votre client.
Définissez toujours output_format: "png". Enregistrez ensuite l’image décodée sous .png sans inspecter les en-têtes de fichier.
Exemple JavaScript (Node.js)
Flux de réponse
Cet endpoint est synchrone. Après l’envoi dePOST /images/generations, gardez la Request HTTP actuelle ouverte jusqu’à la réponse du serveur. Lorsque la génération réussit, le contenu de l’image est renvoyé dans data[0].b64_json.
L’endpoint ne renvoie pas de task_id, et il n’existe pas d’endpoint distinct de requête de statut ou de téléchargement de résultat.
Délais d’attente et tentatives
- Réglez les délais d’attente du client HTTP sur plusieurs minutes.
- Réessayez les erreurs de transport,
408,409,425,429et5xx. - Ne réessayez pas automatiquement
400,401, les paramètres manquants ou les Request malformées. - Utilisez un backoff exponentiel comme
3s,8set15s. - Si les images dupliquées sont inacceptables, enregistrez votre propre ID de Request avant de réessayer.
Gestion des erreurs
Les erreurs renvoient généralement du JSON. Lors de l’affichage d’une erreur, lisez d’aborderror.message, puis message, puis le texte de statut HTTP.
Checklist d’intégration
- La Base URL est
https://bettertoken.ai/v1. - L’en-tête contient
Authorization: Bearer YOUR_API_KEY. - La Request utilise
application/jsonetPOST /images/generations. modelestgpt-image-2,response_formatestb64_json,output_formatestpngetnest1.sizeest l’une des valeurs recommandées, par exemple1024x1024.- Votre client HTTP autorise plusieurs minutes pour la génération.
Documents associés
Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corps
Use the GPT Image 2 model ID.
gpt-image-2 "gpt-image-2"
A detailed description of the image to generate.
"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic."
Use 1. Send separate requests when you need multiple output images.
1
The requested image size or aspect-ratio tier. The server may map or adjust the final pixel dimensions, so inspect the decoded image for its actual size.
auto, 1024x1024, 1536x1024, 1024x1536, 1536x1152, 1152x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 "1024x1024"
Use b64_json.
b64_json "b64_json"
Use png. Do not rely on jpeg or webp being returned directly in the selected format.
png "png"
Réponse
Image generation result.

