文生图

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

公开字段：model、prompt、aspect_ratio、width、height、response_format、seed、n、prompt_optimizer。

POST /v1/images/generations

Image-01 文生图

cURL

curl --request POST \
  --url https://api.powertokens.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "image-01",
  "prompt": "A cinematic sunrise over a calm harbor",
  "aspect_ratio": "16:9",
  "response_format": "b64_json",
  "seed": 0,
  "n": 1,
  "prompt_optimizer": false
}
'

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

prompt · string · 必填

图像生成提示词。

aspect_ratio · string

目标宽高比。

width · integer

目标宽度。

height · integer

目标高度。

response_format · enum<string>

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

可用选项: url, b64_json

seed · integer<int64>

随机种子。显式传 0 会被保留。

n · integer

期望返回的图片数量。

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

prompt_optimizer · boolean

是否启用提示词优化。显式传 false 会被保留。

响应

200

application/json

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

created · integer<int64>

data · object[]

Show child attributes

metadata · object

Show child attributes