画像
画像バリエーションの作成
指定された画像のバリエーションを作成します
概要
このエンドポイントは、既存のOpenAI Variationsクライアントをサポートしています。新しいimage-to-image機能については、現在のimage-to-imageモデルとともに /v1/images/edits または /v1/images/generations を使用してください。リクエストには multipart/form-data を使用します。
リクエストボディ
このエンドポイントは同期的です。レスポンスには最終的な画像が含まれ、タスクが返されることはありません。HTTPクライアントのタイムアウトは少なくとも 120s に設定してください。
マルチパートのソース画像。ファイルおよびリクエストボディ全体は、それぞれ50 MiB以内に収まる必要があります(これより大きいアップロードは 413 を返します)。サポートされているフォーマットと解像度は選択したモデルによって異なります。詳細情報で image-to-image が /v1/images/variations にマッピングされているモデルのみが受け入れられます。それ以外のモデルは 400 を返します。
モデルID。このエンドポイントにはデフォルトモデルがありません。例ではプレースホルダー your-legacy-variation-model を使用しています。詳細にこのエンドポイントが記載されているモデルに置き換えてください。
1生成する画像の数(1〜10、モデルに依存)。
生成される画像のサイズ。サポートされている値は選択したモデルによって異なります。
生成された画像が返される形式。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://..."
}
]
}注意事項
これはレガシー互換用のエンドポイントです。現在推奨されている画像モデルカタログには含まれていません。新規の統合では、gpt-image-2 を指定した /v1/images/edits、または operation: "image-to-image" と現在のimage-to-imageモデルを指定した /v1/images/generations を使用してください。
認証
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
application/json
application/json