开始使用
首次调用 API
使用本站创建的 API 密钥,选择可用模型,沿用熟悉的 SDK 或直接发送 HTTP 请求。
连接配置
示例地址自动跟随当前站点,包含协议和端口。OpenAI SDK 的 base_url 通常以 /v1 结尾;直接请求时使用完整端点,避免重复添加 /v1。
请使用在本站创建的密钥。模型厂商的账户密码或其他站点的密钥不能代替本站 API 密钥。
| 参数 | 说明 |
|---|---|
base_urlURL | http://localhost/v1 |
api_keysecret | 登录控制台 → API 密钥,创建并复制密钥;不要放进公开网页或 Git 仓库。 |
modelstring必填 | 从本站模型列表复制完整模型 ID;可用模型取决于密钥绑定的分组。 |
开始之前
确认密钥已启用、余额或订阅可用,并绑定了支持目标模型的分组。先请求 GET /v1/models 核对精确模型 ID。
export API_KEY="YOUR_API_KEY"
curl http://localhost/v1/models -H "Authorization: Bearer $API_KEY"发送第一条消息
curl http://localhost/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [
{
"role": "user",
"content": "Hello!"
}
]
}'读取响应
Chat Completions 的文本通常位于 choices[0].message.content。读取 usage 获取上游报告的用量;本站最终扣费以使用记录中的账单为准。
{
"id": "chatcmpl_example",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello!"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 5,
"total_tokens": 15
}
}