跳转到主要内容
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-0-250828",
  "prompt": "将图片转换为宫崎骏动画风格",
  "image": "https://example.com/input.jpg",
  "size": "2048x2048"
}
'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ]
}

授权

​
Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>。

请求体

application/json
​
model
enum<string>
必填

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

可用选项:
seedream-4-0-250828
​
prompt
string
必填

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

​
image
必填

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

​
size
string
默认值:1K

输出图像尺寸。

  • 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]。

必填范围: -1 <= x <= 2147483647
​
sequential_image_generation
enum<string>
默认值:disabled

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

可用选项:
auto,
disabled
​
sequential_image_generation_options
object

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

​
watermark
boolean
默认值:false

是否添加水印。

响应

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

​
created
integer<int64>

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

​
data
object[]

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