Skip to main content
POST

支持的模型

Authorizations

string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
必填
模型名称
  • z-image-turbo - 轻量快速图片生成,支持中英双语
string
必填
图像生成的文本描述,最多 800 字符
string
默认值:"1:1"
图像宽高比支持的宽高比:
  • 1:1 - 正方形(默认)
  • 4:3 - 横向 4:3
  • 3:4 - 纵向 3:4
  • 16:9 - 横向宽屏
  • 9:16 - 纵向竖屏
  • 3:2 - 横向 3:2
  • 2:3 - 纵向 2:3
string
默认值:"1K"
分辨率档位
  • 1K - 标准分辨率(默认)
  • 2K - 高清分辨率
boolean
默认值:"false"
智能改写提示词开启后,AI 会自动优化提示词,生成效果更好,费用会有所增加。
  • false - 关闭(默认)
  • true - 开启

尺寸对照表

通过 size(比例)+ resolution(分辨率档位)组合控制输出尺寸。

使用场景示例

基础文生图(最简请求)
指定比例和分辨率
开启智能改写

Response

integer
响应状态码
array
返回数据数组

注意事项

  1. 异步处理:提交后返回 task_id,需轮询 /v1/tasks/{task_id} 获取结果
  2. 图片存储:生成的图片已镜像到平台 CDN,长期有效
  3. 计费规则:按成功生成的图片张数计费,失败不扣费
  4. 固定张数:Z-Image-Turbo 固定每次生成 1 张,不支持 n 参数