Z Image Turbo API
集成高性能 AI 图像生成能力。本开发文档提供完整 API 参考、集成指南与代码示例，帮助开发者快速构建 AI 图像应用。
快速上手
仅需两个步骤即可完成你的第一次 API 调用：提交生成任务，然后轮询查询任务状态。
提交任务
向生成接口发送 POST 请求以获取 Task ID。
查询状态
使用 Task ID 检查进度，直到获取图片 URL。
身份验证
Authorization: Bearer {YOUR_API_KEY}注意：请妥善保管 API Key，不要在客户端代码中暴露。
https://zimageturbo.ai/api/generate
创建一个新的图像生成任务。此接口为异步调用，将立即返回 task_id 与任务初始状态；请调用 /api/status 来获取最终生成的图片。
请求体参数
| 参数名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 是 | 用于生成图像的文本提示（最多 1000 字符）。 |
| aspect_ratio | string | 是 | 生成图像的宽高比。可选值：1:1, 4:3, 3:4, 16:9, 9:16。 |
{
"code": 200,
"message": "success",
"data": {
"task_id": "task_1234567890",
"status": "IN_PROGRESS"
}
}https://zimageturbo.ai/api/status
查询任务执行状态与生成结果。
查询参数
| 参数名称 | 必填 | 描述 |
|---|---|---|
| task_id | 是 | 提交任务时返回的任务 ID。 |
{
"code": 200,
"message": "success",
"data": {
"status": "SUCCESS",
"task_id": "xxxxxxxx",
"request": {
"prompt": "xxx",
"size": "1024*1024",
"seed": "-1"
},
"response": [
"https://xxx.com/sample.jpeg"
],
"consumed_credits": 15,
"created_at": "2025-12-05 13:05:09",
"error_message": null
}
}
计费
每次生成费用
失败任务不收费。
错误处理
- 401 未授权无效的 API Key
- 402 需要付款余额不足
- 429 请求过多触发速率限制
关于 Z Image Turbo
Z Image Turbo 基于最新扩散模型优化，将推理速度提升至传统模型的 300%，同时保持极高画面保真度。适用于实时交互、游戏素材生成、电商视觉设计等场景。
Z-Image-Turbo — 6B-parameter, ultra-fast text-to-image
Z-Image-Turbo is a 6B-parameter text-to-image model from Tongyi-MAI, engineered for production workloads where latency and throughput really matter. It uses only 8 sampling steps to render a full image, achieving sub-second latency on data-center GPUs and running comfortably on many 16 GB VRAM consumer cards.
Ultra-fast generation with production-ready quality
Where many diffusion models need dozens of steps, Z-Image-Turbo is aggressively optimised around an 8-step sampler. That keeps inference extremely fast while still delivering photorealistic images and reliable on-image text, making it a strong fit for interactive products, dashboards, and large-scale backends—not just offline batch jobs.
Why it looks so good?
- • Photorealistic output at speed — Generates high-fidelity, realistic images that work for product photos, hero banners, and UI visuals without multi-second waits.
- • Bilingual prompts and text — Understands prompts in English and Chinese, and can render multilingual text directly in the image—helpful for cross-market campaigns, posters, and screenshots.
- • Low-latency, low-step design — Only 8 function evaluations per image deliver extremely low latency, ideal for chatbots, configuration tools, design assistants, and any “click → image” experience.
- • Friendly VRAM footprint — Runs well in 16 GB VRAM environments, reducing hardware costs and making local or edge deployments more realistic.
- • Scales for bulk generation — Its efficiency makes large jobs—catalogues, continuous feed images, or auto-generated thumbnails—practical without blowing up compute budgets.
- • Reproducible generations — A controllable seed parameter lets you recreate a previous image or generate small, controlled variations for brand safety and experimentation.
How to use
- prompt – natural-language description of the scene, style, and any on-image text (English or Chinese).
- size (width / height) – choose the output resolution; supports square and rectangular images up to high resolutions (for example, 1536 × 1536).
- seed – set to -1 for random results, or use a fixed integer to make outputs reproducible.