Skip to main content
POST
cURL
POST /v1/images/generations テキストから画像を生成する Endpoint では、application/json のリクエスト本文を使用します。プロンプトを送信し、HTTP リクエストを開いたままにして、同じレスポンスの data[0].b64_json から生成画像を読み取ります。
https://www.bettertoken.ai/v1Base URL として使用します。BetterToken API Key は Authorization: Bearer YOUR_API_KEY で渡します。
ページ右側の Playground で Authorization とリクエスト本文を入力し、https://www.bettertoken.ai/v1/images/generations へ直接リクエストを送信できます。
API Key をフロントエンドのブラウザーコード、Git リポジトリ、チケット、スクリーンショット、ログに含めないでください。サーバー側のプロキシ呼び出しでは、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)

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 クライアントのタイムアウトは数分に設定します。
  • 通信エラー、4084094254295xx は再試行します。
  • 400401、パラメーター不足、形式不正のリクエストは自動再試行しないでください。
  • 3s8s15s などの指数バックオフを使用します。
  • 重複画像を許容できない場合は、再試行前に独自のリクエスト ID を記録します。

エラー処理

エラーは通常 JSON で返されます。エラーを表示する場合は、まず error.message、次に message、最後に HTTP ステータステキストを読み取ります。

統合チェックリスト

  • Base URL は https://www.bettertoken.ai/v1 です。
  • ヘッダーには Authorization: Bearer YOUR_API_KEY を含めます。
  • リクエストでは application/jsonPOST /images/generations を使用します。
  • modelgpt-image-2response_formatb64_jsonoutput_formatpngn1 です。
  • size には 1024x1024 などの推奨値を指定します。
  • HTTP クライアントで生成用に数分を許容します。

関連ドキュメント

承認

Authorization
string
header
必須

Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.

ボディ

application/json
model
enum<string>
デフォルト:YOUR_MODEL_ID
必須

固定使用 YOUR_MODEL_ID。

利用可能なオプション:
YOUR_MODEL_ID
:

"YOUR_MODEL_ID"

prompt
string
必須

图片生成提示词。

:

"一张未来感 AI 产品海报,浅色背景,玻璃质感,干净构图,高级科技感"

n
integer
デフォルト:1

推荐固定为 1。多张图片建议发起多次独立请求。

必須範囲: 1 <= x <= 1
:

1

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

图片尺寸和比例档位。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"

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

推荐固定为 b64_json,便于稳定保存图片。

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

"b64_json"

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

推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。

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

"png"

レスポンス

Image generation result.

OpenAI-compatible image response. Clients should read data[0].b64_json and allow additional fields such as revised_prompt.

created
integer
:

1710000000

data
object[]