跳转到主要内容
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.powertokens.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedream-4-5-251128",
  "prompt": "一只可爱的柯基犬在草地上奔跑，阳光明媚，写实风格",
  "size": "2048x2048",
  "response_format": "url"
}
'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>",
      "error": {
        "code": "<string>",
        "message": "<string>"
      }
    }
  ],
  "metadata": {}
}

授权

​
Authorization
string
header
必填

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

请求体

application/json
​
model
enum<string>
必填

图像生成模型名称。支持的模型包括 seedream-5-0-260128、seedream-4-5-251128、seedream-4-0-250828。

可用选项:
seedream-5-0-260128,
seedream-4-5-251128,
seedream-4-0-250828
​
prompt
string
必填

图像生成提示词。建议不超过 300 个汉字或 600 个英文单词。

​
image

参考图片。当前公开的 Seedream 模型支持 1-14 张参考图。

​
size
string

输出图像尺寸。

  • seedream-5-0-260128：支持 2K/3K 或自定义（总像素 3686400-10404496，宽高比 1/16-16）
  • seedream-4-5-251128：支持 2K/4K 或自定义（总像素 3686400-16777216，宽高比 1/16-16）
  • seedream-4-0-250828：支持 1K/2K/4K 或自定义（总像素 921600-16777216，宽高比 1/16-16）
示例:

"2048x2048"

​
response_format
enum<string>
默认值:url

响应格式。

可用选项:
url,
b64_json
​
seed
integer
默认值:-1

随机数种子。部分 Seedream 模型支持。取值范围 [-1, 2147483647]。

​
sequential_image_generation
enum<string>
默认值:disabled

组图功能开关。auto 为自动判断模式，disabled 为关闭组图（仅生成单图）。当前支持的 Seedream 模型均可使用该能力。

可用选项:
auto,
disabled
​
sequential_image_generation_options
object

组图功能配置。仅当 sequential_image_generation=auto 时生效。

​
watermark
boolean
默认值:true

是否添加水印。

响应

调用成功，返回图像生成结果。

​
created
integer<int64>

创建时间的 Unix 时间戳（秒）。

​
data
object[]

生成的图像列表。组图场景下可能包含多张图片。

​
metadata
object

附加结果信息。字段内容会随能力不同而变化。