跳到主要内容
万川

快速接入

四步完成第一次调用。已经在用 OpenAI SDK 的项目，通常只需要改 base URL 和 API key 两处。

Base URL 固定为 https://chuanapi.com/v1。密钥仅在控制台创建，本站不托管密钥。

1. 获取 API Key

  1. 打开 控制台登录。
  2. 创建 API Key，并确认余额足以发起计费调用。
  3. 把密钥写入环境变量，例如 WANCHUAN_API_KEY，不要硬编码进源码。

密钥格式、存放位置与 401 / 403 的区分见 认证与密钥。

2. 设置 Base URL

在 OpenAI 兼容客户端里把 base URL / base_url 改为：

https://chuanapi.com/v1

注意末尾的 /v1 不能省。漏掉它会得到 404， 这是迁移时最常见的第一个报错。

3. 选择 model id

从 模型目录 复制真实 model id，替换示例中的 MODEL_ID。也可以用接口列出当前账号可见的模型：

curl https://chuanapi.com/v1/models \
  -H "Authorization: Bearer $WANCHUAN_API_KEY"

不要沿用其他平台的模型名——万川的 model id 以本站公开目录为准， 目录之外的名称会返回 404。

4. 发起第一次请求

curl https://chuanapi.com/v1/chat/completions \
  -H "Authorization: Bearer $WANCHUAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python：

# pip install openai
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["WANCHUAN_API_KEY"],
    base_url="https://chuanapi.com/v1",
)

resp = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js：

// npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.WANCHUAN_API_KEY,
  baseURL: "https://chuanapi.com/v1",
});

const resp = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

首调排查清单

按这个顺序查，基本能覆盖第一次接入的全部失败：

  1. 404：Base URL 漏了 /v1，或 model id 不在目录里。
  2. 401：密钥缺失或拼错； 检查是否把 Bearer 重复写进了密钥值。
  3. 402：余额不足，先充值。
  4. 403：密钥有效但账号分组不含该模型， 换一个目录中可用的 model id 验证。
  5. 400：参数越界， 常见是 max_tokens 超过该模型的最大输出。

完整状态码含义与重试策略见 错误码。

下一步