跳转到主要内容
POST
https://api.ppio.com
/
v3
/
seedream-4.0
Seedream 图片生成 4.0
curl --request POST \
  --url https://api.ppio.com/v3/seedream-4.0 \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "size": "<string>",
  "sequential_image_generation": "<string>",
  "max_images": 123,
  "watermark": true
}
'
{
  "images": [
    "<string>"
  ]
}
Seedream 4.0 是一款先进的图像生成模型，提供灵活的图像创建功能，包括支持4K分辨率，可以从文本和其他图像生成图像。
本接口支持个人认证及企业认证用户调用。请参见 实名认证，完成个人用户认证或企业用户认证，以确保可以正常使用本功能。

​
请求头

​
Content-Type
string
必填
枚举值: application/json
​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
请求体

​
prompt
string
必填
用于生成图像的提示词，支持中英文。建议不超过300个汉字或600个英文单词。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视图片缺失部分元素。
​
images
string[]
输入要编辑的图像的Base64编码或可访问的URL。支持输入单张或多张图像。
  • 图像URL：确保图像URL可访问。
  • Base64编码：格式必须为data:image/<图像格式>;base64,<Base64编码>。
     输入图像必须满足以下要求：
    • 图像格式：jpeg, png
    • 宽高比（宽度/高度）：范围为[1/3, 3]
    • 宽度和高度（像素）：> 14
    • 大小：不超过10 MB
    • 总像素值：不超过 6000×6000 PX
    • 支持上传最多10张参考图像。
​
size
string
设置生成图像的规格。有两种方法可用，但不能同时使用。
  • 方法1，指定分辨率。
    • 可选值：1K, 2K, 4K
  • 方法2，指定生成图像的宽度和高度（像素）。
    • 默认值：2048x2048
    • 总像素值范围：[1024x1024, 4096x4096]
    • 宽高比值范围：[1/16, 16]
推荐的宽度和高度：
宽高比宽度和高度像素值
1:12048x2048
4:32304x1728
3:41728x2304
16:92560x1440
9:161440x2560
3:22496x1664
2:31664x2496
21:93024x1296
​
sequential_image_generation
string
默认值:"disabled"
控制是否禁用批量生成功能。
  • auto：在自动模式下，模型会根据用户的提示词自动决定是否返回多张图像以及包含多少张图像。
  • disabled：禁用批量生成功能。模型将只生成一张图像。
​
max_images
integer
默认值:15
指定此请求中要生成的最大图像数量。此参数仅在sequential_image_generation设置为auto时有效。取值范围：[1, 15]
说明实际生成的图像数量受max_images和输入参考图像数量的影响。输入参考图像数量 + 生成图像数量 ≤ 15。
​
watermark
boolean
默认值:true
为生成的图像添加水印。
  • false：不添加水印。
  • true：在图像添加文字的水印，标识由人工智能生成合成。

​
响应

​
images
string[]
包含生成图像下载链接的数组。