如何集成 Z Image Turbo API：低成本图像生成（$0.0036/张）生产指南

本指南旨在客观且以实现为先，你将学习到：

• 什么是 ZImage Turbo 及其核心功能
• EvoLink 的 ZImage 端点如何工作（异步任务 + Webhook 规则）
• 如何在集成 ZImage Turbo 的同时实现成本控制和运维保障
• 什么时候适合把 ZImage 作为默认选择，什么时候不适合

1. 什么是 ZImage Turbo

• 具有高视觉忠实度的照片级图像生成
• 直接在生成图像中进行双语文本渲染（中英文）
• 适合高通量生产的极速推理速度
• 确保输出一致且可预测的指令遵循能力

ZImage Turbo 视觉质量示例 A	ZImage Turbo 视觉质量示例 B

2. ZImage 价格背景：参考公开价格表进行对比

• EvoLink 模型目录列出的 ZImage Turbo 价格为每张图 $0.0036 起，并显示其“市场”参考价为 $0.0050。
• EvoLink 在其关于 ZImage Turbo 的更新日志中也提到了 ~$0.0036/张 的价格。
• fal.ai 的价格页面显示几种广泛使用的托管图像模型价格在 每张图 $0.03-$0.04 左右（视型号而定）。
• fal.ai 也将 Z-Image Turbo 价格列为 $0.005/megapixel（可用作 ZImage 本身的市场参考）。

成本对比表（透明假设）

假设：“1万张图片”是指生成 10,000 张约 1MP 大小的图片（例如 1024×1024 ≈ 1MP）。请务必确认为你的具体计划和输出尺寸确定的计费规则。

3. EvoLink ZImage Turbo API 如何工作（原生的异步设计）

1. 你通过 POST /v1/images/generations 提交一个 ZImage 生成请求
2. 你会立即收到一个任务 ID (task ID)
3. 你可以通过 GET /v1/tasks/{task_id} 查询任务状态（或使用 Webhook 回调）

4. ZImage Turbo 快速入门（复制/粘贴）

4.1 创建 ZImage 生成任务

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <YOUR_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "z-image-turbo",
  "prompt": "A clean product hero shot, studio lighting, soft shadow, minimal background, no watermark",
  "size": "1:1"
}
'

{
  "id": "task_abc123",
  "status": "pending",
  "model": "z-image-turbo",
  "progress": 0,
  "created": 1735100000,
  "task_info": {
    "can_cancel": true,
    "estimated_time": 10
  },
  "usage": {
    "credits_reserved": 1
  }
}

4.2 查询 ZImage 任务状态

curl --request GET \
  --url https://api.evolink.ai/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <YOUR_TOKEN>'

5. ZImage Turbo 参数说明

• prompt: 必填，最大 2000 个字符。
• size: 支持比例（1:1、16:9 等）或自定义尺寸（376x376 到 1536x1536）。
• seed: 整数（1 - 2147483647），用于重现结果。
• callback_url: 用于异步通知的 HTTPS URL。

6. ZImage Webhook：回调规则

• 仅限 HTTPS: 不允许使用内部 IP。
• 重试机制: 最多重试 3 次（间隔分别为 1s、2s、4s）。
• 格式: 回调正文与任务查询 API 的响应格式一致。

7. ZImage 的生产模式

• 模式 A：变体育选：低成本生成 4-8 个候选方案并挑选最优选。
• 模式 B：早期持久化：立即将输出存储到你的 S3/OSS 中（链接 24 小时后过期）。
• 模式 C：作业队列：使用解耦的作业程序来处理状态轮询或 Webhook。

8. ZImage 提示词模板

模板：双语海报草案

提示词 (Prompt): 一个简洁的零售海报布局，带有清晰的双语排版。大标题：“Winter Sale” 和 “冬季大促”。副标题：“Up to 50% off” 和 “最高立减50%”。现代网格布局，高对比度，无衬线字体。

9. 决策矩阵

10. 常见问题解答 (FAQ)

• 架构: 6B 模型，S3-DiT 架构，Turbo 使用 8 个 NFE。
• 有效期: 链接有效期为 24 小时。
• 价格: 在 EvoLink.ai 上价格为 $0.0036 起。

结论