Skip to main content
POST
Image-01 文生图

授权

Authorization
string
header
必填

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

请求体

application/json
model
enum<string>
必填

模型名称。可选值:image-01

可用选项:
image-01
prompt
string
必填

图像的文本描述,最长 1500 字符

Maximum string length: 1500
aspect_ratio
enum<string>

图像宽高比,默认为 1:1。可选值:

  • 1:1 (1024x1024)
  • 16:9 (1280x720)
  • 4:3 (1152x864)
  • 3:2 (1248x832)
  • 2:3 (832x1248)
  • 3:4 (864x1152)
  • 9:16 (720x1280)
  • 21:9 (1344x576) (仅适用于image-01)
可用选项:
1:1,
16:9,
4:3,
3:2,
2:3,
3:4,
9:16,
21:9
width
integer

生成图片的宽度(像素)。仅当 model 为 image-01 时生效。注意:widthheight 需同时设置,取值范围[512, 2048],且必须是 8 的倍数。若与 aspect_ratio 同时设置,则优先使用 aspect_ratio

必填范围: 512 <= x <= 2048必须是以下数值的倍数 8
height
integer

生成图片的高度(像素)。仅当 model 为 image-01 时生效。注意:widthheight 需同时设置,取值范围[512, 2048],且必须是 8 的倍数。若与 aspect_ratio 同时设置,则优先使用 aspect_ratio

必填范围: 512 <= x <= 2048必须是以下数值的倍数 8
response_format
enum<string>

返回图片的形式,默认为 url。可选值:url, base64。 ⚠️ 注意:url 的有效期为 24 小时

可用选项:
url,
base64
seed
integer<int64>

随机种子。使用相同的 seed 和参数,可以生成内容相近的图片,用于复现结果。如未提供,算法会对 n 张图单独生成随机种子

n
integer

单次请求生成的图片数量,取值范围[1, 9],默认为 1

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

是否开启 prompt 自动优化,默认为 false.

响应

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

created
integer<int64>
data
object[]
metadata
object