概览使用指南
快速开始
5 分钟内完成第一次 API 调用
本指南将帮助您快速上手 Cogine LLM Gateway，在几分钟内完成第一次 API 调用。
前置条件
- 已部署 Cogine LLM Gateway 实例
- 拥有管理员账号或 API 令牌
- 已配置至少一个模型渠道
如果您还没有部署实例，请联系管理员获取访问地址和令牌。
快速开始
获取 API 密钥
登录管理后台，进入 令牌管理 页面创建新的 API 令牌：
- 点击 添加令牌
- 填写令牌名称
- 设置配额限制（可选）
- 点击 提交 保存
复制生成的令牌，格式通常为 sk-xxxxxxxx。
发送第一个请求
使用以下代码发送您的第一个 API 请求：
curl https://your-gateway-host/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://your-gateway-host/v1"
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "Hello!"}
]
)
print(response.choices[0].message.content)import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: 'https://your-gateway-host/v1',
});
const response = await client.chat.completions.create({
model: 'gpt-4o-mini',
messages: [
{ role: 'user', content: 'Hello!' }
],
});
console.log(response.choices[0].message.content);请将 your-gateway-host 替换为您的网关地址，sk-your-api-key 替换为您的 API 密钥。
验证响应
成功的响应示例：
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-4o-mini",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! How can I assist you today?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 8,
"completion_tokens": 9,
"total_tokens": 17
}
}常见问题
401 Unauthorized
- 检查 API 密钥是否正确
- 确认令牌未过期或被禁用
模型不存在
- 确认请求的模型已在渠道中配置
- 检查模型名称拼写是否正确
连接超时
- 确认网关地址可访问
- 检查网络防火墙配置