本页按新手最容易排查问题的顺序，完成账户、令牌、模型和请求验证。

​
1. 注册账户

访问算无忧注册页面，完成注册并进入控制台。

​
2. 创建 API 令牌

1

进入令牌管理

登录控制台后找到“令牌”或“令牌管理”页面。
2

添加令牌

设置便于识别的名称，并选择与你准备调用的模型匹配的分组。
3

安全保存

创建完成后立即复制令牌，保存到密码管理工具或环境变量中。
这里需要的是算无忧控制台生成的令牌，不是 OpenAI、Google 或 Anthropic 官方平台的 API Key。

​
3. 选择正确的基础地址

使用场景建议地址
OpenAI SDK、ChatGPT 兼容客户端https://suanwuyou.com.cn/v1
手动调用 Chat Completionshttps://suanwuyou.com.cn/v1/chat/completions
Claude 原生兼容客户端通常使用 https://suanwuyou.com.cn，由客户端拼接路径
部分客户端会自动拼接 /v1。如果出现 /v1/v1 或 404，请检查客户端是否已经内置版本路径。

​
4. 查询当前可用模型

curl https://suanwuyou.com.cn/v1/models \
  -H "Authorization: Bearer sk-你的令牌"
返回数组中的 id 就是调用接口时填写的模型名。不同令牌分组可能返回不同的模型列表和价格。

​
5. 发送最小聊天请求

curl https://suanwuyou.com.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "控制台中的模型名称",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://suanwuyou.com.cn/v1",
)

result = client.chat.completions.create(
    model="控制台中的模型名称",
    messages=[{"role": "user", "content": "你好"}],
)

print(result.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的令牌",
  baseURL: "https://suanwuyou.com.cn/v1",
});

const result = await client.chat.completions.create({
  model: "控制台中的模型名称",
  messages: [{ role: "user", content: "你好" }],
});

console.log(result.choices[0].message.content);

​
6. 按顺序排查失败原因

检查令牌是否完整、是否多复制空格，以及请求头是否使用 Bearer。同时确认账户状态和令牌权限。
重新调用模型列表接口，复制返回的模型 id；同时检查基础地址有没有重复 /v1。
确认账户余额充足，令牌分组支持目标模型。分组可能对应不同渠道、能力和价格。
不同模型支持的温度、工具、多模态和结构化输出参数可能不同。先使用最小请求，再逐项增加参数。

​
下一步

打开创建聊天补全，直接在页面中填写参数并复制右侧生成的请求代码。