接入指引
只需三步即可完成接入。
接入地址
- API 地址：
$URL（你的 API 接入域名，国内 / 海外环境不同，请使用对应环境分配的地址） - 控制台：
$CONSOLE_URL（用于创建令牌、查看用量）
下文示例中的 $URL 均指代你的 API 地址。
1. 获取 API Key
- 登录控制台（$CONSOLE_URL）
- 进入「令牌管理」，点击「创建令牌」
- 复制生成的 Key（形如
sk-xxxx），妥善保管
注意
API Key 等同于账户凭证，请勿写入前端代码或公开仓库。泄露后请立即在控制台删除并重建。
占位符说明
文中 $URL、$CONSOLE_URL 为占位符，请替换为你所在环境的实际 API 地址与控制台链接。各环境的接口路径、鉴权方式、模型名称完全一致。
2. 发起第一个请求
以对话接口为例（接口格式与 OpenAI 兼容）：
bash
curl $URL/v1/chat/completions \
-H "Authorization: Bearer $YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好"}]
}'python
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="$URL/v1",
)
resp = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)ts
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.YOUR_API_KEY,
baseURL: '$URL/v1',
})
const resp = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)3. 查看用量
每一笔调用的模型、token 数、费用都可以在控制台（$CONSOLE_URL）的「日志」页面实时查看。