Skip to main content
POST
Z-Image
Z-Image Turbo 是通义实验室的 6B 参数文生图模型,采用蒸馏少步(S3-DiT)架构,出图速度接近实时,擅长写实人像,中英文文字渲染都能处理,适合批量草图、运营素材和快速预览。它只做文生图:不接受参考图,每次请求返回 1 张图;需要参考图编辑时用 Seedream 系列 或 Qwen Image 系列。

快速开始

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果,也可以用 Prefer: wait 在一次调用里等待,或配置 Webhook。

请求参数

string
必填
固定为 z-image-turbo。
string
默认值:"generate"
取值 generate。本模型只支持文生图。
string
必填
图片描述,中英文均可。
string
画面比例:1:1、16:9、9:16、4:3、3:4、3:2、2:3。
string
输出分辨率,1k 或 2k。
通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。 本模型不接受 image_urls、n、seed、quality、negative_prompt、mask_url 和 prompt_extend。以上之外的参数会返回 400,不计费。

限制

计费

按成功出图的固定张价结算,只有一个单价。 单价见 GET /v1/models 返回的 price_config,或控制台「模型市场」。单次调用的实际花费见任务响应里的 cost——整数 quota,500,000 quota = 1 USD,不是美元。 分辨率、画幅与提示词长度都不影响价格,提交前即可确定单次费用。 只有成功出图才计费。任务失败、取消,或没有返回可用图片时,全额退款。

响应

任务完成
result.images 返回生成的图片,expires_at 是该链接的失效时间戳。完整字段说明见查询任务状态。

相关文档