技术文档
快速开始
CallStack AI Gateway 完全兼容 OpenAI API 规范。集成仅需更改 Base URL，无需修改任何代码。
端点配置
每个模型服务商拥有独立的网关端点：
Anthropic Claude
claude.callaiapi.comOpenAI
openai.callaiapi.comGoogle Gemini
gemini.callaiapi.comDeepSeek
deepseek.callaiapi.com认证
所有请求需在 Authorization 请求头中携带 API Key：
Authorization: Bearer csk-your-api-keyAPI Key 可通过管理后台或管理 API 进行管理。
兼容性
网关接受标准 OpenAI API 格式的请求。任何支持 OpenAI 的 SDK、框架或工具均可直接使用：
| 框架 | 配置方式 |
|---|---|
| OpenAI Python SDK | 设置 base_url 参数 |
| OpenAI Node.js SDK | 设置 baseURL 选项 |
| LangChain | 在 ChatOpenAI 上设置 base_url |
| Vercel AI SDK | 在 createOpenAI 上设置 baseURL |
| LlamaIndex | 在 OpenAI LLM 上设置 api_base |
| cURL / HTTP | 替换请求 URL |
可用模型
| 模型 | 标识符 | 端点 |
|---|---|---|
| Claude Opus 4 | claude-opus-4-20250514 | claude.callaiapi.com |
| Claude Sonnet 4 | claude-sonnet-4-20250514 | claude.callaiapi.com |
| GPT-4o | gpt-4o | openai.callaiapi.com |
| GPT-4o Mini | gpt-4o-mini | openai.callaiapi.com |
| o3 | o3 | openai.callaiapi.com |
| Gemini 2.5 Pro | gemini-2.5-pro | gemini.callaiapi.com |
| DeepSeek V3 | deepseek-chat | deepseek.callaiapi.com |
| DeepSeek R1 | deepseek-reasoner | deepseek.callaiapi.com |
完整模型列表请参阅支持模型。
API 参考
Chat Completions
POST /v1/chat/completions标准 OpenAI Chat Completions 格式。支持流式输出、函数调用和多模态输入（取决于模型）。
Models
GET /v1/models返回指定网关端点上可用的模型列表。
Embeddings
POST /v1/embeddings使用支持的嵌入模型生成向量表示。
速率限制
| 方案 | 请求/分钟 | Token/分钟 |
|---|---|---|
| 入门版 | 60 | 100,000 |
| 专业版 | 300 | 500,000 |
| 企业版 | 定制 | 定制 |
错误码
| 状态码 | 说明 | 处理方式 |
|---|---|---|
| 401 | 认证失败 | 检查 API Key |
| 403 | 权限不足 | 检查 Key 权限范围与模型访问权限 |
| 429 | 超出速率限制 | 降低请求频率或升级方案 |
| 500 | 内部服务器错误 | 重试或联系技术支持 |
| 503 | 上游服务不可用 | 上游模型暂时不可用 |
技术支持
如需技术支持，请联系我们的工程团队：
- 邮箱：support@callaiapi.com
- 企业版：专属 Slack 频道