参考文档v1.0.0 稳定版本

Z Image Turbo API

集成高性能 AI 图像生成能力。本开发文档提供完整 API 参考、集成指南与代码示例，帮助开发者快速构建 AI 图像应用。

https://zimageturbo.ai

快速上手

仅需两个步骤即可完成你的第一次 API 调用：提交生成任务，然后轮询查询任务状态。

提交任务

向生成接口发送 POST 请求以获取 Task ID。

查询状态

使用 Task ID 检查进度，直到获取图片 URL。

身份验证

注意：请妥善保管 API Key，不要在客户端代码中暴露。

HTTP Header

Authorization: Bearer {YOUR_API_KEY}

POST

https://zimageturbo.ai/api/generate

创建一个新的图像生成任务。此接口为异步调用，将立即返回 task_id 与任务初始状态；请调用 /api/status 来获取最终生成的图片。

此接口会立即返回 task_id；请轮询 /api/status，直到任务状态为 SUCCESS 来获取图像 URL。

请求体参数

参数名称	类型	必填	描述
`prompt`	string	是	用于生成图像的文本提示（最多 1000 字符）。
`aspect_ratio`	string	是	生成图像的宽高比。可选值：1:1, 4:3, 3:4, 16:9, 9:16。

返回示例（JSON）

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://zimageturbo.ai/api/status

查询任务执行状态与生成结果。

查询参数

参数名称	必填	描述
`task_id`	是	提交任务时返回的任务 ID。

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

计费

每次生成费用

$0.02 / 次请求

失败任务不收费。

错误处理

401 未授权无效的 API Key
402 需要付款余额不足
429 请求过多触发速率限制

关于 Z Image Turbo

Z Image Turbo 基于最新扩散模型优化，将推理速度提升至传统模型的 300%，同时保持极高画面保真度。适用于实时交互、游戏素材生成、电商视觉设计等场景。

Z-Image-Turbo — 60 亿参数，超高速文本生成图像模型

Z-Image-Turbo 是 Tongyi-MAI 推出的 60 亿参数文本生成图像模型，为低延迟生产环境打造，仅使用 8 个采样步骤即可渲染完整图像，实现亚秒级延迟。

极速生成 · 商用级画质

相较于许多扩散模型依赖数十步生成，Z-Image-Turbo 以 8 步采样实现极快推理速度，并保持照片级真实度与稳定文本生成能力。

为什么表现如此优秀？

高速生成真实影像 —— 适合产品照片、横幅、UI 设计等场景。
支持中英文提示与图中文字 —— 适合跨市场海报、设计与截图。
低延迟低步骤 —— 理想用于交互类产品、设计助手等实时场景。
友好的显存占用 —— 可在 16GB 显卡上运行，降低部署成本。
高效支持批量生成 —— 适用于电商商品、缩略图、内容流生成。
可复现生成 —— 控制 seed 以重现画面或生成可控变化。

使用方式

promptprompt – 使用自然语言描述场景、风格与图像文本内容。
sizesize – 设置输出分辨率，支持方图与高分辨率输出（如 1536×1536）。
seedseed – 设置为 -1 表示随机生成，或使用固定整数以确保可复现。

Z-Image-Edit Prompts