模型名称z-image-turbo
  • 面向更快的图片生成场景
  • 对外统一走图片异步任务协议,提交成功后返回 task_id
  • 当前公开文生图能力
  • size 支持 1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3
  • resolution 支持 1k / 2k
  • 支持 prompt_extend 智能改写提示词
  • 固定每次生成 1

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。 获取 API Key:从平台上获取。 使用时在请求头中添加:

提交任务接口

提交图片异步任务。接口受理成功后会立即返回 task_id,实际图片结果需要通过任务查询接口继续轮询。

请求参数

可选值:
  • size1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 3:2 / 2:3
  • resolution1k / 2k
  1. 当前公开协议不接受参考图输入。
  2. n 只能是 1
  3. prompt_extend=true 会先优化提示词,再执行图片生成。

响应

成功响应示例:
失败响应示例:

任务查询接口

使用提交阶段返回的 task_id 查询当前任务状态。任务成功后,可从结果对象里读取图片地址。 统一规则:响应体 code 为数字 200works 始终是有序数组;处理中或失败时返回空数组。images 表示输入参考图,works 表示输出作品。完整状态和多作品示例见 异步任务查询 任务完成后,可在查询响应中读取生成结果地址。

响应

查询结果示例:

使用示例

文生图

智能改写提示词

注意事项

  1. 当前页面只开放文生图,不开放参考图输入。
  2. n 固定为 1
  3. 提交成功后请使用返回的 task_id 轮询任务结果。