图像
创建图像变体
创建给定图像的变体
概述
这个 API 用于兼容已经在使用 OpenAI Variations 的客户端。新建图生图功能时，请使用 /v1/images/edits 或 /v1/images/generations，并从模型页选择支持图片输入的当前模型。本 API 请求必须使用 multipart/form-data。
请求体
请求超时： 同步图片请求可能需要较长时间，建议把 HTTP 超时设为至少 120s。响应包含 pending、task_id 或 poll_url 时，通过 poll_url 查询结果。
Multipart 源图片。文件和完整请求体均不得超过 50 MiB。支持的格式和尺寸取决于所选模型，其当前详情必须明确列出 /v1/images/variations。
必填模型 ID，本 API 不提供默认模型。新建图生图功能时，请使用 /v1/images/edits 或 /v1/images/generations。
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://..."
}
]
}注意事项
这是旧版兼容端点，不在当前推荐图片模型目录中。新接入请使用 /v1/images/edits + gpt-image-2，或在 /v1/images/generations 中设置 operation: "image-to-image" 并选择当前 image-to-image 模型。
授权
BearerAuth API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
请求头
单次请求的交付策略。覆盖 API 密钥和 Workspace 的默认设置。自动优先尝试 TokenLab Verified，并在输出、请求接受或持久资源创建之前，可能会切换一次至仅限 Official。
可选值
- "auto"
- "verified"
- "official"
请求体
multipart/form-data
响应
application/json
application/json
application/json
application/json
application/json
application/json