请求示例
只需替换 AI 供应商的域名为您的网关域名，其他参数和路径保持不变，即可通过 Tarogo AI 网关调用 AI 服务。
前置条件
- 接收获取邮件中的 API Key（由管理员创建或自主创建），Key 处于启用状态
域名替换规则
核心原理：Tarogo AI 网关兼容 OpenAI API 格式。您只需将请求中的 AI 供应商原始域名替换为您的网关域名，请求路径和其他参数完全保持不变。
按供应商查阅
选择您使用的 AI 供应商，查看对应的域名替换示例。
DeepSeek — 域名替换规则
原 API 地址
https://api.deepseek.com/chat/completions网关地址
https://api.tarogo.com/chat/completionshttps://api.deepseek.com → https://api.tarogo.com/chat/completions
代码示例
以下代码中的域名已自动配置为您的网关地址，模型名已带上 @供应商类型 后缀用于指定供应商。请将 YOUR_API_KEY 替换为邮件中收到的 API Key 即可运行。
curl -X POST https://api.tarogo.com/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat@deepseek",
"messages": [
{
"role": "user",
"content": "你好，请介绍一下自己"
}
],
"stream": false
}'请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称。使用 模型名@供应商类型 格式可指定供应商；不指定 @供应商类型 时，系统按优先级自动选择 |
| messages | array | 是 | 对话消息列表，包含 role 和 content 字段 |
| stream | boolean | 否 | 是否使用流式响应，默认为 false |
响应示例
JSON Response
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1234567890,
"model": "deepseek-chat@deepseek",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好！我是 AI 助手，很高兴为您服务..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 50,
"total_tokens": 60
}
}注意事项
- 请确保 API Key 正确且处于启用状态
- 请确保已在管理后台为对应的 Token 供应商启用了需要的模型
- 请求头中的 Authorization 字段格式为 Bearer YOUR_API_KEY
- Content-Type 必须设置为 application/json
- 域名替换后，路径和请求体参数完全不变，SDK 代码也只需修改 base_url
常见问题
Q: 收到 401 错误
A: 401 错误表示认证失败，请检查 API Key 是否正确。
Q: 收到 404 错误
A: 请确认域名和 baseURI 拼接正确。不同供应商的路径前缀不同。
Q: 收到 429 错误
A: 429 错误表示请求频率超限，请检查您的 Key 配置的 RPM 和 TPM 限制。
Q: 如何切换模型？
A: 修改请求体中的 model 字段即可。
Q: 支持哪些供应商？
A: 支持所有兼容 OpenAI API 格式的供应商。