メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
概要

指定された画像のバリエーションを作成します。multipart/form-data コンテンツタイプが必要です。

​
リクエストボディ

同期リクエストのタイムアウト: ルーティング先の画像プロバイダーによっては、生成完了まで待って最終画像をインラインで返します。高解像度または高品質のリクエストは 1 分前後、またはそれ以上かかることがあるため、HTTP クライアントのタイムアウトは少なくとも 120s に設定してください。作成レスポンスに status: "pending"、task_id、または poll_url が含まれる場合は、返された poll_url をポーリングしてください。
​
image
file
必須
バリエーションの基となる画像。有効な PNG ファイルで、50MB 未満、正方形である必要があります。
​
model
string
デフォルト:"dall-e-2"
画像バリエーションに使用するモデル。現在は dall-e-2 のみサポートされています。
​
n
integer
デフォルト:"1"
生成する画像の数。1 から 10 の間である必要があります。
​
size
string
生成される画像のサイズ。256x256、512x512、または 1024x1024 のいずれかである必要があります。
​
response_format
string
デフォルト:"url"
生成された画像の返却形式。url または b64_json である必要があります。
​
user
string
不正利用監視のためのエンドユーザーの一意識別子。

​
レスポンス

​
created
integer
画像が作成された時の Unix タイムスタンプ。
​
data
array
生成された画像バリエーションの配列。各オブジェクトには以下が含まれます：
  • 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 "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

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

​
注意事項

画像バリエーションは DALL-E 2 でのみ利用可能です。モデルは元の画像とスタイルや内容が類似した新しい画像を生成します。