图像变体

POST

https://api.tokencube.net/v2/llm/images/variations

图像变体API，基于一张原始图像，生成多个风格/细节相似但不完全相同的图像版本，适用于图片多版本选择、创意扩展等场景。

当前展示通用接口文档，各模型支持的参数存在差异。请在顶部切换模型，或直接点击下方模型标签，查看专属文档。

请求参数

请求头

参数名称	描述
Authorizationstring	鉴权令牌，格式为 Bearer ${AIGATEWAY_TOKEN}
Content-Typestring	可选值：multipart/form-data multipart/form-data; boundary=${boundary}，boundary由请求工具自动生成

Body参数

参数名称	描述
modelstring	默认值：Default model configured on the channel 模型名称
imagestring	用作变体基础的图像，PNG格式
ninteger	默认值：1 可选值：1-4 要生成的图像数
response_formatstring	默认值：url 可选值：urlb64_json 生成的图像返回的格式（部分模型仅支持特定格式，会忽略该字段）
sizestring	默认值：1024x1024 可选值：512x512 ~ 2048x2048 生成图像的大小（部分模型仅支持特定分辨率）

curl -v 'https://${base_url}/v2/llm/images/variations' \
  -H "Authorization: Bearer ***" \
  -F "image=@test.png" \
  -F "size=1024x1024"

Body参数

参数名称	描述
createdinteger	生成图像的创建时间戳（Unix时间格式）
dataarray	生成图像数组，数组长度与请求参数n一致
urlstring	生成图像的URL地址，仅当response_format=url时返回（必填）
b64_jsonstring	生成图像内容的Base64编码，仅当response_format=b64_json时返回（必填）

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

描述（message）	HTTP状态码
请求成功，返回编辑后的图像数据	200
访问被拒绝，拒绝原因见响应主体。可能原因：缺少Authorization请求头、token无效或过期等	401
访问被拒绝，拒绝原因见响应主体。可能原因：请求主体格式错误、缺少必填参数（如image、prompt）等	403
服务器内部错误，错误原因见响应主体	500