Skip to main content
POST
cURL
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 で渡します。
ページ右側の Playground で Authorization とリクエスト本文を入力し、https://bettertoken.ai/v1/images/generations へ直接リクエストを送信できます。
API Key をフロントエンドのブラウザーコード、Git リポジトリ、チケット、スクリーンショット、ログに含めないでください。サーバー側のプロキシ呼び出しでは、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)

output_format: "jpeg" または output_format: "webp" を指定して、JPEG または WebP ファイルを直接受け取れることに依存しないでください。現在の Endpoint は PNG の画像内容を返す場合があります。プロダクトで JPEG または WebP が必要な場合は、まず PNG を受け取り、自身のコードで変換してください。

レスポンスの流れ

この 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 クライアントで生成用に数分を許容します。

関連ドキュメント

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ボディ

application/json
model
enum<string>
デフォルト:gpt-image-2
必須

Use the GPT Image 2 model ID.

利用可能なオプション:
gpt-image-2
例:

"gpt-image-2"

prompt
string
必須

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."

n
デフォルト:1

Use 1. Send separate requests when you need multiple output images.

例:

1

size
enum<string>
デフォルト:1024x1024

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"

response_format
enum<string>
デフォルト:b64_json

Use b64_json.

利用可能なオプション:
b64_json
例:

"b64_json"

output_format
enum<string>
デフォルト:png

Use png. Do not rely on jpeg or webp being returned directly in the selected format.

利用可能なオプション:
png
例:

"png"

レスポンス

Image generation result.