画像
画像バリエーションを作成
指定された画像のバリエーションを作成します
概要
このエンドポイントは、従来の OpenAI 互換 variation クライアント向けに保持されています。現在の image-to-image ワークフローでは推奨パスではありません。可能な場合は /v1/images/edits と gpt-image-2、または /v1/images/generations で nano-banana-pro などの image-to-image モデルを使用してください。multipart/form-data が必要です。
リクエストボディ
同期リクエストのタイムアウト: ルーティング先の画像プロバイダーによっては、生成完了まで待って最終画像をインラインで返します。高解像度または高品質のリクエストは 1 分前後、またはそれ以上かかることがあるため、HTTP クライアントのタイムアウトは少なくとも 120s に設定してください。作成レスポンスに status: "pending"、task_id、または poll_url が含まれる場合は、返された poll_url をポーリングしてください。
Multipart の入力画像。ファイルとリクエスト全体はそれぞれ 50 MiB 以内にしてください。対応形式と寸法はモデルに依存し、現在のモデル詳細に /v1/images/variations が明記されている必要があります。
従来の variation 互換ルート向けの必須モデル ID。暗黙のデフォルトはありません。現在の image-to-image ワークフローでは、現在のモデルを使って /v1/images/edits または /v1/images/generations を優先してください。
1生成する画像の数（1-10、モデルに依存）。
従来の variation 互換ルートで生成される画像サイズ。サポートされる値は選択したモデルによって異なります。
生成された画像の返却形式。url または b64_json である必要があります。
不正利用監視のためのエンドユーザーの一意識別子。
レスポンス
画像が作成された時の Unix タイムスタンプ。
生成された画像バリエーションの配列。
各オブジェクトには以下が含まれます：
url(string): バリエーション画像の URL（response_format がurlの場合）b64_json(string): Base64 エンコードされた画像（response_format がb64_jsonの場合）
リクエスト
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=your-legacy-variation-model" \
-F "image=@cat.png" \
-F "n=2" \
-F "size=1024x1024"レスポンス
{
"created": 1706000000,
"data": [
{
"url": "https://..."
},
{
"url": "https://..."
}
]
}注意事項
これは従来互換のエンドポイントであり、現在の推奨画像モデルカタログには含まれません。新規連携では /v1/images/edits と gpt-image-2、または /v1/images/generations で operation: "image-to-image" と現在の image-to-image モデルを使用してください。
認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
ヘッダー
リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。
指定できる値
- "auto"
- "verified"
- "official"
リクエストボディ
multipart/form-data
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json