Skip to content

快速开始 ​

准备三样东西:一个已登录的控制台账号、足够支付本次调用的额度,以及一个只在服务端使用的 API 令牌。

1. 创建令牌 ​

  1. 打开控制台并完成注册或登录。
  2. 按页面提示充值。未支付成功的订单不会增加额度。
  3. 新建 API 令牌,名称写成用途,例如「本地调试」。
  4. 复制令牌。关闭弹窗后通常不能再次查看完整令牌,遗失就重新创建并作废旧的。

建议为不同项目分开建令牌,并给每个令牌设置额度上限。

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

保存后先发一句很短的测试话。失败时优先核对这四项,而不是先改业务提示词。

草案,非正式法律意见。上线前须由执业律师按实际业务复核。