ERNIE-Image

ERNIE-Image × Civitai Orchestration API 完全指南：免 GPU 云端文生图与 Buzz 计费

Jul 2, 2026

ERNIE-Image × Civitai Orchestration API 完全指南：免 GPU 云端文生图与 Buzz 计费

从 ERNIE-Image 开源以来，开发者们一直在寻找最简单的方式来调用这个 8B DiT 模型。本地部署需要 GPU、云端部署需要配置环境——直到 Civitai Orchestration API 的出现，这一切变得完全不同。

Civitai 将 ERNIE-Image 纳入了其 Orchestration API，开发者现在可以通过一个 REST API 端点直接调用 ERNIE-Image 进行图像生成，无需任何本地硬件、模型下载或环境配置。更令人兴奋的是，Turbo 模式将生成速度提升了 3-4 倍，成本降至原来的三分之一。

本文将深入解析 Civitai Orchestration API 的 ERNIE-Image 集成，从 API 调用到成本优化，帮助你快速上手云端文生图。

什么是 Civitai Orchestration API

Civitai Orchestration API 是一个统一的 AI 工作流编排平台，支持图像、视频、音频和文本生成。它的核心理念是"工作流而非端点"——你描述要做什么工作，编排器自动选择供应商、路由任务并流式返回结果，你不需要管理任何容量。

关键特性：

  • 多供应商默认：FAL、Google、字节跳动、Civitai 工作节点——编排器竞赛选择最佳供应商
  • 类型化配方目录：每个任务类型（视频生成、图像生成、超分辨率等）都有经过验证的输入和可预测的输出
  • 同步或异步：轮询、订阅或内联等待，支持 webhook 用于生产集成
  • MCP 原生：连接 Claude Desktop、claude.ai 或任何 MCP 感知客户端

ERNIE-Image 在 Civitai API 中的两种模式

Civitai Orchestration API 为 ERNIE-Image 提供了两种模式：

模式 默认步数 默认 CFG Scale 适用场景
ernie（标准） 20 4 默认高质量输出，标准采样
turbo 8 1 蒸馏加速——3-4 倍更快，约 1/3 的 Buzz 成本

关键调优提示：Turbo 模式下必须将 cfgScale 保持为 1。Turbo 是经过蒸馏的模型，不像标准变体那样对 classifier-free guidance 有响应。提高 CFG Scale 通常会导致输出过饱和/烧焦。

API 调用完全指南

基础请求结构

端点：POST https://orchestration.civitai.com/v2/consumer/workflows?wait=60

请求头：

Authorization: Bearer <TOKEN>
Content-Type: application/json

标准模式示例

{
  "steps": [
    {
      "$type": "imageGen",
      "input": {
        "engine": "comfy",
        "ecosystem": "ernie",
        "model": "ernie",
        "operation": "createImage",
        "prompt": "A red panda wearing a yellow rain jacket, cinematic soft light, highly detailed",
        "width": 1024,
        "height": 1024,
        "steps": 20,
        "cfgScale": 4,
        "sampler": "euler",
        "scheduler": "simple",
        "quantity": 1
      }
    }
  ]
}

Turbo 模式示例

只需将 "model" 改为 "turbo"，"steps" 改为 8，"cfgScale" 改为 1：

{
  "steps": [
    {
      "$type": "imageGen",
      "input": {
        "engine": "comfy",
        "ecosystem": "ernie",
        "model": "turbo",
        "operation": "createImage",
        "prompt": "A red panda wearing a yellow rain jacket, cinematic soft light, highly detailed",
        "width": 1024,
        "height": 1024,
        "steps": 8,
        "cfgScale": 1,
        "sampler": "euler",
        "scheduler": "simple",
        "quantity": 1
      }
    }
  ]
}

核心参数详解

字段 默认值 范围 说明
prompt — ≤ 10,000 字符 自然语言效果最佳，擅长处理复杂场景
negativePrompt 无 ≤ 10,000 字符 可选。越短越好，默认输出已经干净
width / height 1024 64-2048（16 的倍数） 在 1024² 附近训练，接近 1 百万像素时表现良好
steps 20 1-150 超过 25 步后边际收益递减。Turbo 保持 6-12
cfgScale 4 0-30 甜蜜点：3-5。Turbo 锁定为 1
sampler euler 枚举 模型针对 euler 调优
scheduler simple 枚举 标准调度器
loras {} { airUrn: strength } 可叠加多个。仅 urn:air:ernie:lora:... 兼容
quantity 1 1-12 每次调用的图像数量
seed 随机 int64 固定种子实现可重复生成

Buzz 计费模型

Civitai 使用 Buzz 积分系统按次计费。

定价公式

标准模式：total = 20 × (width × height / 1024²) × (steps / 20) × quantity

Turbo 模式：total = 8 × (width × height / 1024²) × (steps / 8) × quantity

实际成本参考

配置 标准 (Buzz) Turbo (Buzz)
1024² / 默认步数 / quantity: 1 20 8
832×1216 / 默认步数 / quantity: 1 ~20 ~8
1024² / 默认步数 / quantity: 4 ~80 ~32
1024² / steps: 40(标准) / steps: 16(Turbo) ~40 ~16

标准模式定价约为 Turbo 的 2.5 倍。建议：使用 Turbo 进行 prompt 迭代，确认满意后再用标准模式生成最终版本。

运行时间

变体 尺寸 预期耗时
ernie（标准） 1024² / 20 步 ~29 秒
ernie（标准） 832×1216 / 20 步 ~27 秒
turbo 1024² / 8 步 ~13 秒

响应格式与签名 URL

API 返回标准的 imageGen 输出，包含 images[] 数组：

{
  "status": "succeeded",
  "steps": [{
    "$type": "imageGen",
    "name": "$0",
    "status": "succeeded",
    "output": {
      "images": [{
        "id": "aa6e7228-68cd-4d15-b4d7-5005b2bfbac6-0.jpg",
        "width": 1024,
        "height": 1024,
        "url": "https://orchestration.civitai.com/v2/consumer/blobs/…?sig=…",
        "urlExpiresAt": "2027-04-15T17:18:54.3195353Z",
        "previewUrl": "https://orchestration.civitai.com/v2/consumer/blobs/…?sig=…",
        "available": true,
        "nsfwLevel": "pg13"
      }],
      "errors": []
    }
  }]
}

重要：url 和 previewUrl 是签名链接且有有效期。如需长期使用，重新获取工作流或调用 GetBlob 获取新鲜 URL。nsfwLevel 包含内容审核分类。

异步调用与轮询策略

wait=60 适用于单图像调用。对于 quantity > 1、大尺寸或高步数，计算加排队会超过 60 秒。

推荐轮询策略：

  1. 提交时设置 wait=60
  2. 如果超时，循环 GET /v2/consumer/workflows/{id}?wait=60 直到最终状态
  3. 生产环境注册 webhook 回调

LoRA 支持

Civitai API 仅支持 ERNIE 标记的 LoRA（urn:air:ernie:lora:...）。

在请求中添加 LoRA：

{
  "loras": {
    "urn:air:ernie:lora:civitai:12345@67890": 0.8
  }
}

多个 LoRA 可以叠加，通过不同的 AIR URN 引用。

使用场景

1. Prompt 迭代测试

使用 Turbo 模式快速测试不同的 prompt 组合，成本极低（8 Buzz/张），13 秒即可得到结果。

2. 批量生成

设置 quantity: 12，一次调用生成最多 12 张图像，适合电商产品图、社交媒体内容批量生产。

3. API 集成

将 Civitai API 集成到自有应用中，无需管理 GPU 基础设施。支持 webhook 回调，适合异步生产流程。

4. 多分辨率测试

ERNIE-Image 在 1024² 附近表现最佳，但 64-2048（16 的倍数）都支持。使用 API 快速测试不同分辨率的效果。

常见问题

Q: 与本地部署相比有什么优势？

无需 GPU 硬件、无需模型下载、无需环境配置。API 调用即生成，适合快速原型验证和小规模生产。

Q: Turbo 模式画质损失多大？

Turbo 模式通过 DMD 和 RL 蒸馏优化，在 8 步内即可达到可接受的美学质量。对于 prompt 迭代和草稿生成，画质损失不明显。最终出图建议使用标准模式。

Q: 如何获取 Civitai API Token？

在 Civitai 开发者平台注册并生成 API Token。具体流程见 Civitai Developer 文档。

Q: 支持 img2img 或编辑操作吗？

目前仅支持 createImage（文生图）。img2img、变体生成和图像编辑暂不支持。

总结

Civitai Orchestration API 为 ERNIE-Image 提供了零门槛的云端调用方式。核心优势：

  • 零硬件要求：无需 GPU、无需下载模型
  • Turbo 加速：3-4 倍速度，1/3 成本
  • 批量能力：单次调用最多 12 张
  • LoRA 兼容：支持 ERNIE 生态 LoRA
  • MCP 原生：可与 Claude Desktop 等工具集成

对于需要快速测试 prompt、批量生成图像或集成 AI 生成到自有应用的用户，Civitai Orchestration API 是目前最简单的 ERNIE-Image 调用方式。

ERNIE-Image Team