CheaperGen

入门指南

CheaperGen API 文档

通过一个 REST API，使用来自 ByteDance、Alibaba 和 MiniMax 的官方视频和图像生成模型，价格低于官方目录价。提交任务后可轮询状态或接收 Webhook。切换模型只需更改一个字符串。

MCP

通过 AI 智能体创作

让 Claude、ChatGPT、Cursor 或 Codex 帮你生成视频或图片，费用从余额中扣除。将这段内容粘贴到你的智能体中即可完成一次性设置。

Set up CheaperGen for me by following https://cheapergen.com/agents/setup.md

Setup for each agent
REST API

使用编程智能体开发

让 Claude Code、Cursor 或 Codex 编写代码，从你的应用调用我们的 API；密钥存放在环境变量中，并可免费测试。

Add CheaperGen video and image generation to this project by following https://cheapergen.com/agents/integrate.md

智能体读取的内容

要自己编写代码？快速入门不写代码？打开 Studio

快速入门

两分钟内从 API 密钥生成第一个视频，支持 JavaScript、Python 或 cURL。

身份验证

Bearer API keys, where to keep them and how to rotate them.

生成任务

异步任务流程：排队 → 运行 → 成功或失败。

Webhooks

任务完成时接收通知并验证签名。

API 参考文档

查看所有端点、参数和响应对象。

模型

查看所有模型端点 ID、价格和各模型 API 文档。

基础 URL#

所有端点都使用同一个带版本号的基础 URL。请求和响应均为 HTTPS 上的 JSON；金额单位为美元。

https://cheapergen.com/api/v1

使用方式#

  1. 提交 生成任务，并传入 POST /api/v1/run/{endpoint}。价格会从预付余额中冻结，响应会返回生成任务以及 status: "queued"（HTTP 202）。
  2. 等待 任务完成：每隔几秒轮询 GET /api/v1/generations/{id}，或者传入 webhook_url，我们会通过 POST 将结果发送给你。参见 生成任务。
  3. 下载 从 output.video.url 或 output.images[].url 下载输出。如果任务失败，冻结金额会自动退还；生成失败不会收费。
POST /api/v1/run/bytedance/seedance-2.0-fast/text-to-video
curl -X POST https://cheapergen.com/api/v1/run/bytedance/seedance-2.0-fast/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "黄金时刻，陶艺家缓缓将陶土塑成花瓶，光线中尘埃浮动，浅景深，镜头缓慢推进",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

模型#

每种任务都有专属端点（例如文生视频和图生视频），且使用相同的请求结构：模型输入字段，以及可选的 webhook_url。你可以在 模型 页面查看完整价格表，或通过 GET /api/v1/models 获取。

约定#

  • 使用 Authorization: Bearer cg_live_… 进行身份验证，详情见 身份验证。
  • 生成任务 ID 以 gen_ 开头。时间戳使用 UTC 时区的 ISO 8601 格式。金额字段以 _usd 结尾，使用十进制美元金额。
  • 错误始终采用 { "error": { "code", "message", "param" } } 格式，并返回有意义的 HTTP 状态码。参见 错误。
  • 未知请求参数会被拒绝并返回 400 invalid_request，因此拼写错误不会悄悄改变输出。
  • 公开端点（/models 和 /quote）无需密钥，可安全地从浏览器调用。

面向 AI 智能体和大语言模型#

API 和所有模型的机器可读摘要位于 /llms.txt。每款模型还有专属 API 页面，完整输入结构由 API 实际用于验证的同一份目录生成。

智能体也可以直接调用 CheaperGen：将我们托管的 MCP 服务器 连接到 Claude Code、ChatGPT、Codex、Cursor 或 VS Code，或安装 CheaperGen 智能体 Skill。如果你想让编程智能体把 API 接入自己的项目，请粘贴上面的“编程智能体”句子；它会遵循 /agents/integrate.md。

有不清楚或缺少的内容？发邮件至 support@cheapergen.com——我们会认真阅读每一封邮件。