图像
创建图像变体
创建给定图像的变体
概述
这个 API 用于兼容已经在使用 OpenAI Variations 的客户端。新建图生图功能时，请使用 /v1/images/edits 或 /v1/images/generations，并选择当前的图生图模型。请求使用 multipart/form-data。
请求体
部分请求会立即返回最终图片，请把 HTTP 客户端超时设为至少 120s。如果响应包含 status: "pending"、task_id 或 poll_url，请使用返回的 URL 获取结果。
Multipart 源图片。文件和完整请求体均不得超过 50 MiB。支持的格式和尺寸取决于所选模型，其当前详情必须明确列出 /v1/images/variations。
模型 ID。本 API 没有默认模型。
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