API de génération d’images OpenAI compatible : guide GPT Image 2
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://www.bettertoken.ai/v1 comme Base URL. Passez votre BetterToken API Key via Authorization: Bearer YOUR_API_KEY.Démarrage rapide avec curl
Utilisezhttps://www.bettertoken.ai/v1 comme Base URL et envoyez une Request à https://www.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://www.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
Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.
Corps
固定使用 YOUR_MODEL_ID。
YOUR_MODEL_ID "YOUR_MODEL_ID"
图片生成提示词。
"一张未来感 AI 产品海报,浅色背景,玻璃质感,干净构图,高级科技感"
推荐固定为 1。多张图片建议发起多次独立请求。
1 <= x <= 11
图片尺寸和比例档位。auto 为自动;1024x1024 和 2048x2048 为 1:1;1536x1024 为 3:2;1024x1536 为 2:3;1536x1152 为 4:3;1152x1536 为 3:4;2048x1152 和 3840x2160 为 16:9;2160x3840 为 9:16。实际返回像素可能由服务端映射或调整,客户端应以解码后的真实图片尺寸为准。
auto, 1024x1024, 1536x1024, 1024x1536, 1536x1152, 1152x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 "1024x1024"
推荐固定为 b64_json,便于稳定保存图片。
b64_json "b64_json"
推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。
png "png"

