快速开始
准备三样东西:一个已登录的控制台账号、足够支付本次调用的额度,以及一个只在服务端使用的 API 令牌。
1. 创建令牌
- 打开控制台并完成注册或登录。
- 按页面提示充值。未支付成功的订单不会增加额度。
- 新建 API 令牌,名称写成用途,例如「本地调试」。
- 复制令牌。关闭弹窗后通常不能再次查看完整令牌,遗失就重新创建并作废旧的。
建议为不同项目分开建令牌,并给每个令牌设置额度上限。
2. 填写接口根地址
OpenAI 兼容客户端使用:
text
https://【域名】/v1根地址已经包含 /v1。客户端如果还会自己再拼一次 /v1,请求会打到错误路径。模型请填控制台卡片上的 模型 ID,不要填展示名称。
3. 发出第一次请求
下面的示例只说明调用形状。请把密钥放在环境变量里,不要写进仓库。
python
import os
from openai import OpenAI
client = OpenAI(
base_url="https://【域名】/v1",
api_key=os.environ["API_KEY"],
)
response = client.chat.completions.create(
model="【模型 ID】",
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(response.choices[0].message.content)返回里应能看到助手消息。若状态码不是 200,先对照错误码检查令牌、余额和模型 ID。
4. 接到已有工具
多数编辑器和 Agent 只需要四项:
| 设置 | 填写 |
|---|---|
| 协议 | OpenAI 兼容 |
| 接口根地址 | https://【域名】/v1 |
| 密钥 | 控制台创建的令牌 |
| 模型 | 控制台中的模型 ID |
保存后先发一句很短的测试话。失败时优先核对这四项,而不是先改业务提示词。