Tsuki 个人 API 中转站

Tsuki 接入文档

OpenAI 协议兼容的个人 AI 中转站——一个 Base URL、一把令牌,聚合多家上游模型,任何 OpenAI 格式的客户端与 SDK 都能直接使用。

Base URL https://tsuki.ageha.cn/v1

01快速开始

  1. 获取 API Key
    打开 tsuki.ageha.cn 登录 → 控制台 → 令牌 → 新建/复制一个 sk- 开头的令牌。令牌可设置额度、过期时间与可用模型范围。
  2. 配置 Base URL
    在客户端/SDK 里把接口地址设为上方 https://tsuki.ageha.cn/v1(注意带 /v1)。
  3. 选择模型发请求
    模型名见下方模型列表,或直接请求 GET /v1/models 实时获取。
所有接口与 OpenAI 官方协议一致:/v1/chat/completions(支持流式)、/v1/models 等,把官方地址换成 Tsuki 即可。

02接入示例

curl

curl https://tsuki.ageha.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-flash",
    "messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
  }'

Python(openai SDK)

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="agnes-2.5-flash",
    messages=[{"role": "user", "content": "用一句话介绍 Tsuki"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "qwen3.8-flash",
  messages: [{ role: "user", content: "数到三" }],
  stream: true,
});
for await (const chunk of resp) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");

桌面客户端(Cherry Studio / ChatBox / NextChat 等)

设置里选择「OpenAI」类型供应商,API 地址填 https://tsuki.ageha.cn(客户端要求带 /v1 就带),Key 填站点令牌,模型名手动填入或点「获取模型列表」。

ZCode / 编码类工具(Cline 等)

新增自定义 Provider:API 地址 https://tsuki.ageha.cn/v1,Key 填站点令牌,模型填 agnes-2.5-flash、glm-5.3-flash 等;建议把输出上限(max tokens)设置为 ≤ 65536,避免超出上游限制报 400。

03可用模型

常用模型如下,实际可用列表以 GET /v1/models 返回为准(令牌设置了模型限制时以令牌范围为准)。

模型说明
agnes-2.5-flashagnes-3.0-flashAgnes 系列,日常对话/编码,速度快
glm-5.3-flash推荐智谱 GLM-5.3 Flash,性价比高
glm-5.3glm-4.7glm-4.5-air智谱 GLM 系列
qwen3.8-flashqwen3.8-max阿里 Qwen 系列
deepseek-v4.1-flashDeepSeek V4.1 Flash(阿里百炼承载)
gemini-3-flashGemini 3 Flash(第三方承载)

04常见问题

401 / 令牌无效

确认使用的是 sk- 开头的完整令牌(控制台「令牌」页),令牌可能已过期、额度用尽或被限定了模型范围。

503 / 「无可用渠道」

该模型当前没有可用渠道(上游故障或被站主临时禁用)。换个模型,或稍后再试。

400 max_tokens 超限

客户端的输出上限设置超过了模型限制,调低(一般 ≤ 65536)即可。

支持流式输出吗?

支持。请求体加 "stream": true,返回标准 SSE。

忘记管理台密码

联系站主重置。

05服务状态

curl https://tsuki.ageha.cn/api/status

返回 "success":true 即服务在线。管理台地址:https://tsuki.ageha.cn