OpenAI SDK 怎么接入词元 API:Python、Node.js、curl 示例
如果你的项目已经用了 OpenAI SDK,接入词元 API 通常只需要改 base_url、api_key 和 model 三项。
一句话答案:base_url 填
https://api.token-ciyuan.com/v1,api_key 填控制台创建的 Token,model 填控制台可用模型名。先用最小请求确认返回、日志和余额变化,再接入正式应用。推荐步骤
登录词元 API 控制台,创建一个专用 Token。
把 SDK 的 base_url 改为
https://api.token-ciyuan.com/v1。把 Token 填到 api_key 或 Authorization Bearer。
选择控制台可用模型名,先发一个短请求。
回控制台查看使用日志、余额和错误信息。
Python OpenAI SDK 示例
from openai import OpenAI
client = OpenAI(
api_key="sk-你的词元Token",
base_url="https://api.token-ciyuan.com/v1",
)
resp = client.chat.completions.create(
model="qwen-plus",
messages=[
{"role": "user", "content": "用一句话介绍词元 API"}
],
)
print(resp.choices[0].message.content)
Node.js OpenAI SDK 示例
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的词元Token",
baseURL: "https://api.token-ciyuan.com/v1",
});
const resp = await client.chat.completions.create({
model: "qwen-plus",
messages: [
{ role: "user", content: "用一句话介绍词元 API" }
],
});
console.log(resp.choices[0].message.content);
curl 最小请求
curl https://api.token-ciyuan.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的词元Token" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-plus",
"messages": [
{"role": "user", "content": "测试一下接口是否可用"}
]
}'
常见错误怎么排查
401 Invalid Token
检查 Token 是否完整、Authorization 是否是 Bearer 格式、base_url 是否重复拼接 /v1,并确认这个 Token 没有被删除。
403 / 1010 / Forbidden
先用 curl 或最小 SDK 示例复现,确保有正常 User-Agent、请求路径正确,并回控制台看日志是否出现。
余额不足
余额属于登录账号,不属于某个 API Key。充值前先确认充值页显示的到账账号,再从钱包给当前账号充值。
模型不存在
模型名要以控制台当前可用列表为准。不要只填俗称,建议复制控制台里显示的精确模型名。