Skip to main content
POST

Authorizations

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

Body

string
必填
模型名称。固定值:"z_image_turbo"
object
必填
模型参数对象。
string
必填
调用方自定义任务 ID,用于幂等提交和查询结果。
  • 长度为 1-64 个字符
  • 只允许字母、数字、下划线和连字符
  • 同一个 API Key 下不能重复使用
Z-Image Turbo 仅支持文生图。参考图(image_url)、图片编辑、分辨率档位(resolution)和批量出图(output_n)均不支持;传入自定义像素尺寸 size 会直接返回 Model "z_image_turbo" does not support size parameter。每次请求固定返回 1 张图片,需要多张时请用不同 seed 多次提交。需要参考图、图生图或更大画布时,请改用 GPT-Image 2、Seedream 5.0 Pro 或 Nano Banana Pro。

Response

string
调用方任务 ID,可用于查询结果。
string
初始状态,固定为 "pending"。
number
本次任务的预估消耗额度。
string
创建时间,ISO 8601 格式。

查询结果

提交成功后,使用相同的 out_task_id 调用:
任务状态包括 pending、processing、completed 和 failed。任务完成后,结果图片位于 data.output,实际消耗位于 data.credits_used。任务生成失败时,系统会自动退回本次任务的预扣额度。