AI
Song AI Gateway
API 网关运行中

拿到 key 后，从这里开始用。

这是统一 AI API 网关，不是聊天网页。你需要把管理员发给你的 sk-... key 填到 Trae、Cursor、Claude Code、 Open WebUI 或 OpenAI SDK 里使用。

直接打开域名看到这个页面表示入口正常。真正的模型调用走 /v1/chat/completions、 /v1/messages 等 API 路径。

新手路径

还没有编辑器的人，先装 Trae 或 Cursor，再让编辑器里的 AI 读本页完成配置。

Trae

下载 Trae，然后安装 Claude Code 插件

打开官方站点下载桌面版。安装后在 Extensions / 插件市场里搜索 Claude Code 并安装。

打开 Trae 官网
Cursor

下载 Cursor，然后安装 Claude Code 插件

打开官方下载页安装。安装后在 Extensions / 插件市场里搜索 Claude Code 并安装。

打开 Cursor 下载页
交给 IDE AI 的提示词

让 Cursor / Trae 帮你填配置

把下面这段粘给编辑器里的 AI，把 sk-... 换成管理员发给你的 key。

请阅读 https://song-ai-api.com/ 这份 Song AI Gateway 使用说明。

我的 API Key 是：sk-...
我的使用类型是：个人 / 团队
我已经安装了 Claude Code 插件。

请帮我完成 Claude Code 的配置，并检查是否能正常使用。
注意：
1. Claude Code 的 ANTHROPIC_BASE_URL 不要带 /v1；
2. 个人入口用 https://song-ai-api.com；
3. 团队入口用 https://staging.song-ai-api.com；
4. OpenAI 兼容客户端才使用 https://song-ai-api.com/v1；
5. 配完后请帮我用模型列表或一个最小请求自检。

快速开始

按你使用的客户端类型选一种，不要把两个 Base URL 混在一起。

Claude Code / Anthropic 格式

BASE_URL 不带 /v1

Claude Code 会自己拼接 /v1/messages，这里填裸域即可。

export ANTHROPIC_BASE_URL="https://song-ai-api.com"
export ANTHROPIC_AUTH_TOKEN="sk-..."
claude
Cursor / Open WebUI / OpenAI SDK

Base URL 要带 /v1

OpenAI 兼容客户端通常要填完整 API base。

OPENAI_BASE_URL="https://song-ai-api.com/v1"
OPENAI_API_KEY="sk-..."

客户端配置

团队 key 把域名替换为 staging.song-ai-api.com。

Claude Code settings.json

推荐写到用户级配置

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://song-ai-api.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-..."
  }
}
Python OpenAI SDK

适合脚本和服务端调用

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",
    base_url="https://song-ai-api.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "ping"}],
)

拿到 key 后怎么确认没配错

先查模型列表，再发一个最小请求。

  1. 1
    确认网关存活 浏览器能打开本页，或访问 /health/liveliness 返回 alive。
  2. 2
    确认 key 能列出模型 如果返回 401，通常是 key 写错、复制漏字符或用了错误入口。
  3. 3
    确认模型名可用 Claude Code 优先用默认 Sonnet；脚本里可用 claude-sonnet-4-6。 
curl https://song-ai-api.com/v1/models \
  -H "Authorization: Bearer sk-..."

curl https://song-ai-api.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "ping"}],
    "max_tokens": 32
  }'

常见坑

大部分问题都和 Base URL 或模型名有关。

现象 通常原因 处理方式
打开域名以前是 404 网关本来是 API 服务，不是聊天网页 现在根路径会显示本说明页；调用模型仍走 API 路径
Claude Code 连接失败 ANTHROPIC_BASE_URL 误填了 /v1 改成 https://song-ai-api.com 或团队入口裸域
OpenAI SDK 404 或找不到接口 OpenAI 兼容客户端没有带 /v1 Base URL 填 https://song-ai-api.com/v1
401 Unauthorized key 复制错误、key 被停用、或团队/个人入口混用 重新复制 key；团队用户优先用 staging.song-ai-api.com
模型 404 / 403 / 不在列表 当前 key 没有该模型白名单 先用 /v1/models 看自己这把 key 能用哪些模型