画像

画像バリエーションの作成

指定された画像のバリエーションを作成します

POST
/v1/images/variations

概要

このエンドポイントは、既存のOpenAI Variationsクライアントをサポートしています。新しいimage-to-image機能については、現在のimage-to-imageモデルとともに /v1/images/edits または /v1/images/generations を使用してください。リクエストには multipart/form-data を使用します。

リクエストボディ

このエンドポイントは同期的です。レスポンスには最終的な画像が含まれ、タスクが返されることはありません。HTTPクライアントのタイムアウトは少なくとも 120s に設定してください。

imagefile必須

マルチパートのソース画像。ファイルおよびリクエストボディ全体は、それぞれ50 MiB以内に収まる必要があります(これより大きいアップロードは 413 を返します)。サポートされているフォーマットと解像度は選択したモデルによって異なります。詳細情報で image-to-image が /v1/images/variations にマッピングされているモデルのみが受け入れられます。それ以外のモデルは 400 を返します。

modelstring必須

モデルID。このエンドポイントにはデフォルトモデルがありません。例ではプレースホルダー your-legacy-variation-model を使用しています。詳細にこのエンドポイントが記載されているモデルに置き換えてください。

nintegerデフォルト: 1

生成する画像の数(1〜10、モデルに依存)。

sizestring

生成される画像のサイズ。サポートされている値は選択したモデルによって異なります。

response_formatstring

生成された画像が返される形式。url または b64_json である必要があります。

userstring

不正利用の監視を目的とした、エンドユーザーを表す一意の識別子。

レスポンス

createdinteger

画像が作成された時のUnixタイムスタンプ。

dataarray

生成された画像バリエーションの配列。

各オブジェクトの内容:

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

レスポンス

Response
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

注意事項

これはレガシー互換用のエンドポイントです。現在推奨されている画像モデルカタログには含まれていません。新規の統合では、gpt-image-2 を指定した /v1/images/edits、または operation: "image-to-image" と現在のimage-to-imageモデルを指定した /v1/images/generations を使用してください。

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。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