POST
/
v3
/
seedream-3-0-txt2img
即梦文生图
curl --request POST \
  --url https://api.ppinfra.com/v3/seedream-3-0-txt2img \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "prompt": "<string>",
  "seed": 123,
  "width": 123,
  "height": 123,
  "use_pre_llm": true,
  "use_sr": true,
  "return_url": true,
  "logo_info": {
    "add_logo": true,
    "position": 123,
    "language": 123,
    "opacity": 123,
    "logo_text_content": "<string>"
  }
}'
{
  "image_urls": [
    "<string>"
  ],
  "binary_data_base64": [
    "<string>"
  ]
}
使用即梦（Seedream）体验快速高效的图像生成，是一款先进的文生图模型，可根据文本提示生成高质量图片。
本接口支持个人认证及企业认证用户调用。请参见 实名认证，完成个人用户认证或企业用户认证，以确保可以正常使用本功能。

​
请求头

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

​
请求体

​
prompt
string
required
用于生成图像的提示词，中英文均可输入。prompt书写规范参考上文描述。
​
seed
int
随机种子，作为确定扩散初始状态的基础，默认-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成图片极大概率效果一致。默认值：-1
​
width
int
生成图像的宽。默认值：512取值范围：[256, 768]宽、高与512差距过大，则出图效果不佳、延迟过长概率显著增加。超分前建议比例及对应宽高：
  • 1:1：512*512
  • 4:3：512*384
  • 3:4：384*512
  • 3:2：512*341
  • 2:3：341*512
  • 16:9：512*288
  • 9:16：288*512
​
height
int
生成图像的高。默认值：512取值范围：[256, 768]
​
use_pre_llm
bool
开启文本扩写，会针对输入prompt进行扩写优化，如果输入prompt较短建议开启，如果输入prompt较长建议关闭。默认值：true
  1. prompt过短，如长度小于4时，推荐扩写默认打开，保证出图效果更优；
  2. prompt较长，如出图4张，可考虑1次关闭扩写，3次打开扩写，保证出图效果多样性。
​
use_sr
bool
True：文生图+AIGC超分False：文生图默认值：true内置的超分功能，开启后可将上述宽高均乘以2返回，此参数打开后延迟会有增加。如上述宽高均为512和512，此参数关闭出图512512，此参数打开出图10241024。
​
return_url
bool
输出是否返回图片链接（链接有效期为24小时）。
​
logo_info
LogoInfo
水印信息。

​
响应参数

​
image_urls
string[]
生成图片的链接数组。当 return_url 设置为 true 时，该数组包含可下载的图片链接（有效期24小时）。
​
binary_data_base64
string[]
Base64 编码的图片数据数组。当 return_url 设置为 false 时，该数组包含生成图片的 Base64 编码字符串。