CheapBuddy Claude、文本、图片与视频 API 文档

本文档介绍同一现有 CheapBuddy Base URL / API Key 的 Claude 文本接入，以及既有图片生成、视频生成、异步任务查询和结果下载接口。

认证

使用 Authorization: Bearer $CHEAPBUDDY_API_KEY 发送 API 请求。

Claude：同一个入口与现有 Key，两种协议任选其一

公共根地址为 https://api.cheapbuddy.cc。支持 Claude 的 Sub2API 分组可访问六个 Claude 模型，不另建协议专用 Key、不轮换现有 Key。实际模型权限、额度、到期、封禁、余额检查和分组计费均由 Sub2API 现有配置决定。

按客户端能力选择 Anthropic 原生或 OpenAI-compatible。Chat Completions 和 Responses 属于兼容协议类别，不是第三种协议，也不需要同一次推理同时调用。现有根地址或 /v1 Base URL 都可保留，无需 strip-v1 或更换 URL。不同 SDK 追加 /v1/messages 或 /messages；Relay 兼容安全 SDK 路径别名与重复 /v1 形式（如 /v1/v1/messages）。下文使用规范 HTTP 路径，不是要求修改客户端入口。Claude Code 原生示例使用根 Base URL 与 ANTHROPIC_AUTH_TOKEN，值为同一把现有 Key；配置生成器保留用户提供的 URL。

Anthropic 原生 API

使用 x-api-key: $CHEAPBUDDY_API_KEY 或同一 Key 的 Bearer 认证，任选一种；原生请求携带 anthropic-version: 2023-06-01。

POST /v1/messages：同步 JSON 或 stream: true 的 SSE。
POST /v1/messages/count_tokens：输入 Token 计数，不等于最终账单。
GET /v1/models：当前 Key 获准访问的原生模型列表。
GET /v1/models/{model_id}：原生模型详情。

原生模型列表 / 详情保留 Sub2API 响应，不混入媒体记录或补造能力字段；既有 OpenAI-compatible 聚合目录保持原合同。

curl https://api.cheapbuddy.cc/v1/messages \
  -H "x-api-key: $CHEAPBUDDY_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'

OpenAI-compatible 文本 API

WorkBuddy 使用 POST /v1/chat/completions；OpenCode 可选原生 Anthropic 或兼容 Chat；Codex 使用 POST /v1/responses，wire_api = "responses"。Claude 同样可使用这些既有接口，不需要换 Key；Sub2API 负责必要转换。

Relay 只做 HTTP 透传；Sub2API 负责业务语义、鉴权、模型路由、协议转换和文本计费。多轮 / system、工具、图片输入、Thinking 和缓存按 Sub2API 实际支持透传；未知字段、上游错误和 SSE 事件不由 Relay 重写。

模型 ID：claude-fable-5、claude-fable-5-1、claude-opus-5、claude-opus-5-5、claude-sonnet-5、claude-sonnet-5-5。官网模型卡展示 Anthropic 官方参考价；最终扣费沿用请求所属 Sub2API 分组配置，详见接入与价格指南。

首版不包含 Batch、Files、Admin；SDK 接入不保证全部平台特性，HTTP Responses 不等于原生 Responses WebSocket。服务不承诺 100% 可用性 SLA；生产发布与客户端验收状态不由本文档证明。图片、视频和 ComfyUI 的素材、权限、任务轮询与下载流程不变。

视频生成

通过 POST /v1/videos 创建视频任务，再使用 GET /v1/videos/{id} 查询状态。

大 multipart 请求建议携带唯一的 Idempotency-Key。上传完成后即使客户端连接断开，已接收的任务仍会继续提交；POST 仍需等待上传完成后返回任务 ID。

图片生成

GPT Image 2.6 已上线。使用 model: gpt-image-2.6，通过 POST /v1/images/generations 创建图片生成请求。查看 GPT Image 2.6 模型页与实测图片。

curl https://api.cheapbuddy.cc/v1/images/generations \
  -H "Authorization: Bearer $CHEAPBUDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.6","prompt":"A red vintage sports car by the sea","size":"1024x1024","response_format":"b64_json"}'

返回 CheapBuddy 首页