画像生成 API
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://bettertoken.ai/v1 を Base URL として使用します。BetterToken API Key は Authorization: Bearer YOUR_API_KEY で渡します。目的に合うフローを選ぶ
- **テキストから画像を生成して保存する:**このページを使用します。
curlの例から始め、続いて 画像を保存する でdata[0].b64_jsonをデコードします。 - 既存の画像を編集する:Image to imageを使用します。1 つ以上の元画像を
multipart/form-dataとして送信します。 - **モデルとパラメータを選び、予算を見積もる:**現在の Model ID と価格はモデル広場で確認し、リクエストパラメータは下の 推奨値 を参照してください。リクエストとレスポンスの全体像は英語の GPT Image 2 初回リクエスト記事で確認できます。
curl でのクイックスタート
Base URL としてhttps://bettertoken.ai/v1 を使用し、https://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://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 クライアントで生成用に数分を許容します。
関連ドキュメント
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ボディ
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"
レスポンス
Image generation result.

