操作文档

wochenx Gateway 提供 OpenAI / Anthropic 双协议兼容的统一接口,一个 Key 调用多家上游模型。本文档覆盖从注册供应商到首次调用的全部流程。

操作指南

一、注册供应商账户,领取活动奖励

打开平台左侧菜单「平台活动」,页面展示各供应商的限时活动。确认活动奖励后,点击对应活动卡片上的「一键注册」按钮,即可快速完成供应商账户注册。

注意事项:

① 基元律动(tokenrhythm.studio) 与 SiliconFlow(硅基流动) 需先完成实名认证,认证通过后方可领取平台发放的充值奖励;

② 各活动的奖励金额、领取条件以卡片内说明为准,注册后可结合「我的邀请码」邀请好友获取额外返利。

平台活动页

图1-1 平台活动页:各供应商活动奖励与「一键注册」入口

二、新增 API Key(配置上游供应商)

1. 打开左侧菜单「API Key」,点击页面右上角的「+ 新增 API Key」按钮。

API Key 管理页

图2-1 API Key 管理页:点击「新增 API Key」

2. 在弹出的表单中完成如下配置:

① 选择供应商:在下拉列表中选中对应的上游平台;

② API Key:填入该供应商平台的密钥,平台采用 AES-256-GCM 加密存储,可放心提交;

③ 模型 model_name:填写模型 ID(如 deepseek-chat),须与供应商官方文档中的模型名称保持一致,否则路由可能失败;

④ base_url:自动带出该供应商的默认接口地址,一般无需修改;

⑤ 月度 Token 上限、协议类型、认证方式、备注:按需填写。

3. 确认无误后点击「保存 Key」,即完成该供应商的接入配置。

新增 API Key 弹窗

图2-2 新增 API Key 弹窗:选择供应商并填写 API Key 与模型 ID

三、各供应商模型 ID 查询示例

不同供应商的模型 ID 可在其对应页面或文档中查询,以下列出常见平台的查询位置供参考:

基元律动模型列表页

图3-1 基元律动:模型列表页示例

模型选择页

图3-2 模型选择页示例

SenseNova API 文档页

图3-3 商汤 SenseNova 6.8 Flash Lite:API 文档页(model_id 见文档)

供应商 API 文档页

图3-4 供应商 API 文档页示例(model_id 见文档)

Agnes 模型页

图3-5 Agnes:模型页示例

API 文档页

图3-6 API 文档页示例(model_id 见文档)

SiliconFlow 模型广场

图3-7 SiliconFlow 模型广场:模型详情示例

模型选择页(基元律动)

图3-8 模型选择页示例(基元律动)

OpenAI SDK 调用示例

图3-9 官方文档中的 OpenAI SDK 调用示例

模型详情文档页

图3-10 模型详情文档页:model_id 位置标注

四、创建子 Key,并维护通道内 Key

4.1 新增子 Key

进入「子 Key」页面,点击右上角「+ 新增子 Key」按钮生成子 Key。子 Key 用于最终的业务调用鉴权,支持配置通道、模型白名单、QPS 与有效期,并可随时查看调用次数、Token 用量及费用明细。

子 Key 管理页

图4-1 子 Key 管理页:点击「新增子 Key」

4.2 后续补充上游 Key

后续新采购或新注册的供应商 Key,直接加入已有子 Key 的通道内即可,无需重新创建子 Key:

1. 在「子 Key」列表中,点击对应子 Key 的「详情」按钮。

子 Key 列表详情按钮

图4-2 子 Key 列表:点击「详情」进入通道配置

2. 进入详情页后,在「通道内 Key」区块右上角点击「+ 增加 Key」,选中要补充的上游 Key 即可。

子 Key 详情页通道内Key

图4-3 子 Key 详情页:通道内 Key 区块点击「增加 Key」

3. 通道内的 Key 支持按住拖动调整调用顺序,网关会从上到下依次调用;点击「移出」可将该 Key 从通道中移除。

⚠️ 所有下游调用均使用子 Key,请勿直接暴露上游 API Key。

API 接入

① 获取 API Key

登录控制台 → 「子 Key」→ 「+ 新增子 Key」→ 只需填一个通道名称(不存在会自动创建通道,默认装入全部上游 Key 并按供应商顺序排好)→ 生成形如 sk-user-… 的调用密钥。每个子 Key 可单独设置额度 / QPS / 模型白名单 / 过期时间。

② 调用示例(OpenAI 兼容)

# curl
curl https://ai.wochenx.art/v1/chat/completions \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "任意名称(网关自动路由)",
    "messages": [{"role":"user","content":"你好"}],
    "stream": true
  }'
# Python (openai SDK)
from openai import OpenAI
client = OpenAI(api_key="sk-user-你的子Key", base_url="https://ai.wochenx.art/v1")
resp = client.chat.completions.create(
    model="任意名称",
    messages=[{"role":"user","content":"你好"}]
)
print(resp.choices[0].message.content)

③ 支持的端点

端点协议说明
POST /v1/chat/completionsOpenAI对话补全(支持流式)
POST /v1/messagesAnthropicClaude 原生格式,Claude Code 可直连
POST /v1/embeddingsOpenAI向量嵌入
POST /v1/completionsOpenAI传统补全
GET /v1/modelsOpenAI模型列表

💡 模型名由网关按通道策略决定,客户端传的 model 会被路由层接管;模型映射与白名单见控制台「模型映射」。

④ Anthropic 原生(Claude Code 直连)

网关同时兼容 Anthropic Messages 协议,Claude Code / Claude 类客户端可直接接入。

# curl(需带 anthropic-version 头)
curl https://ai.wochenx.art/v1/messages \
  -H "Authorization: Bearer ***" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "任意名称",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"你好"}]
  }'
# Claude Code 配置(~/.claude/settings.json)
{
  "apiKeyHelper": "echo sk-user-你的子Key",
  "baseUrl": "https://ai.wochenx.art/v1",
  "env": { "ANTHROPIC_BASE_URL": "https://ai.wochenx.art/v1" }
}

⑤ 向量嵌入(Embeddings)

# curl
curl https://ai.wochenx.art/v1/embeddings \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "embedding-model-id",
    "input": "需要向量化的文本"
  }'

⑥ 无需指定模型

本网关无需传模型:客户端 model 字段可省略或填任意名称,网关按通道自动路由到当前可用的上游(首选失败自动降级,无需客户端感知)。这也是上面示例里 model 一律写「任意名称」的原因。若子 Key 配置了模型白名单,则白名单外的模型会被拦(403 MODEL_NOT_ALLOWED)。

⑦ 快速对接:让 AI 帮你生成代码

复制下面这段提示词,连同你的子 Key 一并发送给任意 AI 助手(DeepSeek、ChatGPT、Claude 等),即可自动生成可运行的对接代码:

# 提示词
请帮我对接 AI API 网关:
Base URL: https://ai.wochenx.art/v1
Key: sk-xxx...xxxx
请生成可用的对接代码。

常见问题

Q:返回 402 Quota exceeded?

子 Key 的 Token 配额用尽。到控制台「子 Key」查看用量,或联系管理员调整上限。

Q:返回 403 MODEL_NOT_ALLOWED?

该子 Key 配置了模型白名单,请求的模型不在白名单内。

Q:流式输出为空?

多为 max_tokens 设得过小(推理模型的思考 token 吃光了额度),调大即可。

Q:请求被降级(gateway_status=SWITCHED)?

首选上游异常(限流/超时),网关已自动切换到备用上游,属于正常容灾,不计额外费用。

关于

服务名称wochenx Gateway · AI 聚合中转站
协议兼容OpenAI / Anthropic
版本v1.0

如需开通账号或提升额度,请联系管理员。