图生图

适用于 image-01 与 image-01-live 模型的图生图能力。

公开字段：model、prompt、subject_reference、aspect_ratio、width、height、response_format、seed、n、prompt_optimizer。subject_reference 在该文档中按 JSON 请求展开。

POST /v1/images/edits

Image-01 图生图

cURL

curl --request POST \
  --url https://api.powertokens.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "image-01-live",
  "prompt": "Turn this portrait into a manga cover",
  "subject_reference": [
    {
      "type": "character",
      "image_file": "https://example.com/reference.png"
    }
  ],
  "response_format": "url",
  "n": 1
}
'

200

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>"
    }
  ],
  "metadata": {
    "provider_request_id": "<string>",
    "provider_status_code": 123,
    "provider_status_msg": "<string>",
    "success_count": 123,
    "failed_count": 123
  }
}

授权

Authorization · string · header · 必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

model · enum<string> · 必填

当前能力使用的模型名称。

可用选项: image-01, image-01-live

prompt · string · 必填

图像编辑提示词。

subject_reference · object[] · 必填

主体参考信息，用于约束生成结果中的人物或物体一致性。

Minimum array length: 1

Show child attributes

aspect_ratio · string

目标宽高比。

width · integer

目标宽度。

height · integer

目标高度。

response_format · enum<string>

返回格式。使用 url 获取临时下载地址，使用 b64_json 获取 Base64 编码内容。

可用选项: url, b64_json

seed · integer<int64>

随机种子。

n · integer

期望返回的图片数量。

必填范围: 1 <= x <= 9

prompt_optimizer · boolean

是否启用提示词优化。

响应

200

application/json

调用成功，返回统一图像响应结构。

created · integer<int64>

data · object[]

Show child attributes

metadata · object

Show child attributes