API 兼容能力

这里所说的兼容是什么意思

Cheap Model 通过同一个用户侧 API Key 支持几类常见接入方式：

• OpenAI 兼容请求，例如 /v1/chat/completions
• Claude 消息请求，例如 /v1/messages
• 图像、视频、音频和音乐异步任务，例如 /v1/images/generations、/v1/videos/generations、/v1/audios/generations

这样团队可以先用明确接通的模型跑通接入，不会把未知模型自动转给默认上游。请求里请使用带版本号的模型名，例如 gpt-5.5、claude-sonnet-4-5-20250929、gemini-3.1-pro-preview。当前路由按具体模型固定到已登记的上游，而不是按 gpt、claude、gemini 这类家族短名兜底。

大多数迁移通常先从三件事开始：

• 更新凭证
• 把客户端指向 Cheap Model 的连接配置
• 为不同工作负载选择合适的模型与路由策略

Claude 消息请求

使用 Cheap Model 的 Key，按 Anthropic 风格放在 x-api-key 请求头里：

curl https://cheapmodel.org/v1/messages \
  -H "x-api-key: cm_xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"你好"}]
  }'

异步多模态任务

图像、视频和音乐接口会先返回任务 ID，再通过 /v1/tasks/{task_id} 查询结果：

curl https://cheapmodel.org/v1/images/generations \
  -H "Authorization: Bearer cm_xxx" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张电影感的未来城市夜景",
    "size": "16:9",
    "resolution": "2k"
  }'

通常不需要重做的部分

• 面向多个提供商的一条应用层接入路径
• 现有客户端已经适配的请求与响应大体结构
• 继续把产品代码的重心放在提示词、工具调用和业务逻辑上

通常会变化的部分

• 模型名称与提供商可用性
• 不同工作负载下的延迟与成本权衡
• 当你需要严格控制上游时的提供商选择规则
• 如果你想获得更清晰的成本与使用可见性，对观测能力的要求

迁移检查清单

1. 先确认最重要的工作负载类型：文本、图像、视频、音频还是功能型 API。
2. 为每类工作负载列出允许使用的提供商和模型。
3. 决定哪些模型必须固定到指定上游。
4. 在扩大流量前先验证计费、日志和路由是否符合预期。

相关文档

• 路由与上游策略
• GPT 模型
• 模型分类
• 定价与额度