OpenAI 互換画像生成 API:GPT Image 2 ガイド
GPT Image 2 と BetterToken の OpenAI 互換 API を使用してテキストから画像を生成します。API Key、Base URL、パラメーター、Python、JavaScript、エラーを説明します。
POST /v1/images/generations
テキストから画像を生成する Endpoint では、application/json のリクエスト本文を使用します。プロンプトを送信し、HTTP リクエストを開いたままにして、同じレスポンスの data[0].b64_json から生成画像を読み取ります。
https://www.bettertoken.ai/v1 を Base URL として使用します。BetterToken API Key は Authorization: Bearer YOUR_API_KEY で渡します。curl でのクイックスタート
Base URL としてhttps://www.bettertoken.ai/v1 を使用し、https://www.bettertoken.ai/v1/images/generations にリクエストを送信します。
推奨値
すべてのリクエストで、次のフィールドを明示的に送信してください。n > 1 を指定した 1 回のリクエストに依存しないでください。
推奨サイズ
size は想定するアスペクト比とサイズ区分を表します。実際に返されるピクセルはサーバーでマッピングまたは調整される場合があります。出力を要求値に無理に切り抜くのではなく、デコードした画像の寸法を使用してください。
画像を保存する
成功時のレスポンスは、次の OpenAI 互換画像レスポンス形式に従います。data[0].b64_json を読み取り、base64 の画像内容として保存します。レスポンスには revised_prompt などの追加フィールドが含まれる場合があるため、クライアントでこれらのフィールドを許可してください。
常に output_format: "png" を設定してください。その後、ファイルヘッダーを確認せずに、デコードした画像を .png として保存します。
JavaScript の例(Node.js)
レスポンスの流れ
この Endpoint は同期式です。POST /images/generations を送信した後、サーバーが応答するまで現在の HTTP リクエストを開いたままにしてください。生成に成功すると、画像内容が data[0].b64_json に返されます。
この Endpoint は task_id を返さず、個別のステータス照会や結果ダウンロード用の Endpoint もありません。
タイムアウトと再試行
- HTTP クライアントのタイムアウトは数分に設定します。
- 通信エラー、
408、409、425、429、5xxは再試行します。 400、401、パラメーター不足、形式不正のリクエストは自動再試行しないでください。3s、8s、15sなどの指数バックオフを使用します。- 重複画像を許容できない場合は、再試行前に独自のリクエスト ID を記録します。
エラー処理
エラーは通常 JSON で返されます。エラーを表示する場合は、まずerror.message、次に message、最後に HTTP ステータステキストを読み取ります。
統合チェックリスト
- Base URL は
https://www.bettertoken.ai/v1です。 - ヘッダーには
Authorization: Bearer YOUR_API_KEYを含めます。 - リクエストでは
application/jsonとPOST /images/generationsを使用します。 modelはgpt-image-2、response_formatはb64_json、output_formatはpng、nは1です。sizeには1024x1024などの推奨値を指定します。- HTTP クライアントで生成用に数分を許容します。
関連ドキュメント
承認
Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.
ボディ
固定使用 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"

