API 参考
Kasallm 提供与 OpenAI 兼容的 HTTP 接口。本页包含认证、请求示例、流式输出、完整模型目录和错误处理。
概览
Base URL:https://api.kasallm.online/v1
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /chat/completions | 对话补全,支持流式返回 |
| GET | /models | 获取当前可用模型列表 |
网关会根据模型名自动选择可用上游渠道。同一模型有多个渠道时自动负载均衡;请求失败会自动重试并切换渠道。
认证
所有请求需要在 Header 中携带 API Key:
Authorization: Bearer sk-你的密钥
密钥在 控制台 创建。每个 Token 可以单独设置可用模型、额度、过期时间和 IP 白名单。不要把密钥写进前端代码或公开仓库。
请求示例
curl https://api.kasallm.online/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5.3-flash",
"messages": [{"role": "user", "content": "你好"}]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://api.kasallm.online/v1",
api_key="sk-你的密钥",
)
resp = client.chat.completions.create(
model="glm-5.3-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kasallm.online/v1",
apiKey: "sk-你的密钥",
});
const resp = await client.chat.completions.create({
model: "glm-5.3-flash",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
流式输出
设置 "stream": true 后,服务会以 SSE 返回增量内容,适合聊天界面逐字显示。
curl -N https://api.kasallm.online/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5.3-flash",
"messages": [{"role": "user", "content": "写一首短诗"}],
"stream": true
}'
data: {"choices":[{"delta":{"content":"你好"}}]}
data: {"choices":[{"delta":{"content":",世界"}}]}
data: [DONE]
模型目录
/v1/models 按令牌所属分组返回各自的模型,全站共 53 个模型 ID。标「别名」的 ID 与同族模型共用一个上游实现;标「多源」的模型由多条上游线路同时承接,按权重自动分流,单条线路异常时自动切到其余线路,客户端无感知。
当前分组:VIP(Kasa-mrouter)、SVIP(Kasa-Mrouter + TokenRhythm + HCNSEC)、VIP-2(NVIDIA 双 key 实验线路,稳定性有限)、VIP-3(OpenRouter)、VIP-4(Kasa-mrouter 独立档)、VIP-BETA(公益网关内测档,分组倍率 3×,7 个模型,其中 3 个按上游原名直供:step-5-preview / kimi-k3.1-pro / glm-5.3)、EVERYONE(全模型通配档,分组倍率 1×,43 个模型,跨 6 条渠道,不受分组限制)、FREE(免费档,分组倍率 0)。新注册用户直接归属 FREE 组(倍率 0),创建任意 API Key 即可直接调用 FREE 档的 3 个模型,无需充值。模型单价见下方价格表,实际扣费 = 模型单价 × 分组倍率;FREE 组倍率为 0,组内模型不消耗额度。在控制台创建令牌时选择分组,即可调用该档位的模型。
| 模型 ID | 家族 | 上下文 | 能力 | 备注 |
|---|---|---|---|---|
gpt-3.5-turbo | OpenAI | 1M | 视觉 · 工具 | |
gpt-5-mini | OpenAI | 128K | 工具 | 多源 |
gpt-5.2-chat | OpenAI | — | — | 多源 |
gpt-5.3-codex | OpenAI | 256K | 视觉 · 工具 | |
gpt-5.4-mini | OpenAI | 1M | 视觉 · 工具 | |
gpt-5.4-pro | OpenAI | — | — | |
gpt-5.5 | OpenAI | 1M | 工具 | |
gpt-5.5-pro | OpenAI | 1M | 工具 | |
gpt-5.6-luna | OpenAI | 256K | 工具 | 多源 |
gpt-5.6-sol | OpenAI | 1M | 工具 | 多源 |
gpt-5.6-terra | OpenAI | 1M | 工具 | 多源 |
gpt-6-astra-pro | OpenAI | 512K | 视觉 · 工具 | 免费 |
gpt-6-luna | OpenAI | 1M | 工具 | |
gpt-6-sol | OpenAI | — | — | |
gpt-6.1-sol | OpenAI | 1M | 视觉 · 工具 | |
gpt-6.1-terra | OpenAI | 1M | 工具 | |
gpt-6.1-terra-pro | OpenAI | 1M | 视觉 · 工具 | |
text-embedding-3-large | OpenAI | — | — | |
claude-fable-5 | Anthropic | 1M | 工具 | |
claude-fable-5.1 | Anthropic | 1M | 视觉 · 工具 | |
claude-haiku-5.5 | Anthropic | 1M | 视觉 · 工具 | |
claude-opus-4-7-high | Anthropic | — | 视觉 | |
claude-opus-4-8 | Anthropic | 1M | 视觉 · 工具 | |
claude-opus-4.5 | Anthropic | 1M | 工具 | |
claude-opus-4.6 | Anthropic | 1M | 工具 | 多源 |
claude-opus-4.7 | Anthropic | 1M | 视觉 · 工具 | 多源 |
claude-opus-4.8 | Anthropic | 200K | 工具 | |
claude-opus-5 | Anthropic | 256K | 工具 | |
claude-opus-5.5 | Anthropic | 1M | 视觉 · 工具 | |
claude-sonnet-4.5 | Anthropic | 128K | 工具 | 多源 |
claude-sonnet-4.6 | Anthropic | 1M | 工具 | |
claude-sonnet-5 | Anthropic | 256K | 视觉 · 工具 | |
claude-sonnet-5.5 | Anthropic | 1M | 视觉 · 工具 | |
gemini-2.5-flash-lite | 256K | 工具 | ||
gemini-2.5-pro | 256K | 视觉 · 工具 | 多源 | |
gemini-2.5-pro-preview | 1M | 工具 | 免费 | |
gemini-3.1-flash-lite | 1M | 视觉 · 工具 | ||
gemini-3.1-pro-preview | 1M | 视觉 · 工具 | 多源 | |
gemini-3.5-flash | 1M | 视觉 · 工具 | ||
gemini-3.6-flash | 1M | 工具 | ||
gemini-3.8-flash | 256K | 视觉 · 工具 | ||
gemini-4-argon | 256K | 视觉 · 工具 | ||
gemini-omni-1.2-flash | 128K | 视觉 · 工具 | 多源 | |
gemma4-26b-a4b | 256K | 工具 | ||
Qwen3.8 | Qwen | — | — | |
Qwen3.8-Flash | Qwen | — | — | |
glm-5.2 | Zhipu | 1M | 工具 | |
glm-5.3 | Zhipu | 1M | 工具 | 多源 |
glm-5.3-flash | Zhipu | 1M | 工具 | 多源 |
deepseek-v4.1-flash-1017 | DeepSeek | 1M | 视觉 · 工具 | |
DeepSeek-V4.1-Flash-1017 | DeepSeek | 1M | 视觉 · 工具 | 别名 |
kimi-k3.1-pro | Moonshot | 1M | 视觉 · 工具 | |
step-5-preview | StepFun | 1M | 视觉 · 工具 |
上下文与能力按各模型实际承载的上游实现标注,可能随上游调整,以实际返回为准。
模型价格
以下价格按网关当前计费倍率换算,单位为 美元 / 百万 token;人民币按 1 USD = 7 CNY 换算,仅供对账参考。
| 模型 | 输入 $/M | 输出 $/M | 人民币参考(输入 / 输出) |
|---|---|---|---|
gpt-3.5-turbo | 0.50 | 1.50 | ¥3.50 / ¥10.50 |
gpt-5-mini | 0.03 | 0.13 | ¥0.21 / ¥0.91 |
gpt-5.2-chat | 免费 FREE 档 · 分组倍率 0 | ||
gpt-5.3-codex | 0.95 | 4.00 | ¥6.65 / ¥28.00 |
gpt-5.4-mini | 0.15 | 0.60 | ¥1.05 / ¥4.20 |
gpt-5.4-pro | 30.00 | 180.00 | ¥210.00 / ¥1260.00 |
gpt-5.5 | 0.15 | 0.60 | ¥1.05 / ¥4.20 |
gpt-5.5-pro | 0.66 | 1.98 | ¥4.62 / ¥13.86 |
gpt-5.6-luna | 0.07 | 0.20 | ¥0.49 / ¥1.40 |
gpt-5.6-sol | 0.15 | 0.60 | ¥1.05 / ¥4.20 |
gpt-5.6-terra | 0.60 | 2.40 | ¥4.20 / ¥16.80 |
gpt-6-astra-pro | 免费 | ||
gpt-6-luna | 2.50 | 7.50 | ¥17.50 / ¥52.50 |
gpt-6-sol | 1.50 | 4.50 | ¥10.50 / ¥31.50 |
gpt-6.1-sol | 2.00 | 6.00 | ¥14.00 / ¥42.00 |
gpt-6.1-terra | 1.40 | 4.40 | ¥9.80 / ¥30.80 |
gpt-6.1-terra-pro | 3.00 | 15.00 | ¥21.00 / ¥105.00 |
text-embedding-3-large | 0.13 | 0.13 | ¥0.91 / ¥0.91 |
claude-fable-5 | 10.00 | 50.00 | ¥70.00 / ¥350.00 |
claude-fable-5.1 | 0.14 | 0.28 | ¥0.98 / ¥1.96 |
claude-haiku-5.5 | 0.37 | 1.25 | ¥2.59 / ¥8.75 |
claude-opus-4-7-high | 5.00 | 20.00 | ¥35.00 / ¥140.00 |
claude-opus-4-8 | 0.42 | 2.12 | ¥2.98 / ¥14.88 |
claude-opus-4.5 | 1.20 | 3.60 | ¥8.40 / ¥25.20 |
claude-opus-4.6 | 0.15 | 0.50 | ¥1.05 / ¥3.50 |
claude-opus-4.7 | 1.00 | 2.70 | ¥7.00 / ¥18.90 |
claude-opus-4.8 | 1.40 | 4.40 | ¥9.80 / ¥30.80 |
claude-opus-5 | 5.00 | 25.00 | ¥35.00 / ¥175.00 |
claude-opus-5.5 | 0.15 | 1.88 | ¥1.05 / ¥13.12 |
claude-sonnet-4.5 | 0.30 | 1.20 | ¥2.10 / ¥8.40 |
claude-sonnet-4.6 | 0.15 | 0.50 | ¥1.05 / ¥3.50 |
claude-sonnet-5 | 0.95 | 4.00 | ¥6.65 / ¥28.00 |
claude-sonnet-5.5 | 0.43 | 0.87 | ¥3.04 / ¥6.09 |
gemini-2.5-flash-lite | 0.086 | 0.14 | ¥0.60 / ¥1.00 |
gemini-2.5-pro | 0.10 | 0.40 | ¥0.70 / ¥2.80 |
gemini-2.5-pro-preview | 免费 | ||
gemini-3.1-flash-lite | 0.15 | 0.47 | ¥1.05 / ¥3.29 |
gemini-3.1-pro-preview | 0.15 | 0.50 | ¥1.05 / ¥3.50 |
gemini-3.5-flash | 0.03 | 0.13 | ¥0.21 / ¥0.91 |
gemini-3.6-flash | 0.30 | 1.20 | ¥2.10 / ¥8.40 |
gemini-3.8-flash | 0.43 | 2.14 | ¥3.01 / ¥14.98 |
gemini-4-argon | 0.86 | 4.29 | ¥6.02 / ¥30.03 |
gemini-omni-1.2-flash | 0.20 | 0.40 | ¥1.40 / ¥2.80 |
gemma4-26b-a4b | 0.09 | 0.27 | ¥0.63 / ¥1.89 |
Qwen3.8 | 免费 FREE 档 · 分组倍率 0 | ||
Qwen3.8-Flash | 免费 FREE 档 · 分组倍率 0 | ||
glm-5.2 | 1.40 | 4.40 | ¥9.80 / ¥30.80 |
glm-5.3 | 1.40 | 4.40 | ¥9.80 / ¥30.80 |
glm-5.3-flash | 0.15 | 0.50 | ¥1.05 / ¥3.50 |
deepseek-v4.1-flash-1017 | 0.15 | 0.60 | ¥1.05 / ¥4.20 |
DeepSeek-V4.1-Flash-1017 | 0.15 | 0.60 | ¥1.05 / ¥4.20 |
kimi-k3.1-pro | 0.58 | 3.05 | ¥4.08 / ¥21.35 |
step-5-preview | 0.30 | 0.81 | ¥2.10 / ¥5.67 |
错误码
| HTTP | 含义 | 处理建议 |
|---|---|---|
| 401 | 密钥无效或已禁用 | 检查 Authorization 是否正确、Token 是否启用 |
| 400 | 请求参数错误 | 检查模型名、消息格式与 JSON 结构 |
| 404 | 模型不存在 | 请求 /v1/models 确认可用 ID |
| 429 | 请求过于频繁 | 降低并发或稍后重试 |
| 503 | 无可用渠道 | 该模型暂时不可用,稍后重试或联系管理员 |
错误响应格式:
{
"error": {
"message": "Invalid token",
"type": "new_api_error"
}
}
配额与计费
- 价格已按各家官方定价对齐,按输入、输出 token 计费,不同模型倍率不同。
- 免费池模型(FREE 档)调用时不消耗额度,适合测试与低频任务。
- 付费模型需先在充值,充值后账户自动升级为 SVIP,令牌分组留空即按账户等级路由。
- 每个 Token 可单独设置额度、可用模型、过期时间与 IP 白名单。
- 额度用尽后请求会返回 401,需要在控制台补充额度。
- 调用记录包含模型、token 数与消耗额度,可在控制台「日志」中查看。
常见问题
可以在 Cursor / Cline / Cherry Studio 里用吗?
可以。Provider 选 OpenAI Compatible,Base URL 填 https://api.kasallm.online/v1,API Key 填你的密钥。
为什么同一个模型有时快有时慢?
同一模型可能由多个上游共同提供,网关会按渠道状态选择。某个上游响应慢或失败时,请求会重试并切换到其他渠道。个别上游模型冷启动较慢。
如何新增模型或渠道?
由管理员在控制台「渠道」中添加,添加后模型会自动出现在 /v1/models 中。