API 文档 模型与价格 接入参考 控制台
目录

API 参考

Kasallm 提供与 OpenAI 兼容的 HTTP 接口。本页包含认证、请求示例、流式输出、完整模型目录和错误处理。

概览

Base URL:https://api.kasallm.online/v1

方法路径说明
POST/chat/completions对话补全,支持流式返回
GET/models获取当前可用模型列表

网关会根据模型名自动选择可用上游渠道。同一模型有多个渠道时自动负载均衡;请求失败会自动重试并切换渠道。

认证

所有请求需要在 Header 中携带 API Key:

http
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 返回增量内容,适合聊天界面逐字显示。

bash
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]
!
推理类模型会先返回 reasoning_content。如果 max_tokens 太小,token 可能在思考阶段用尽,正文为空。

模型目录

/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-turboOpenAI1M视觉 · 工具
gpt-5-miniOpenAI128K工具多源
gpt-5.2-chatOpenAI——多源
gpt-5.3-codexOpenAI256K视觉 · 工具
gpt-5.4-miniOpenAI1M视觉 · 工具
gpt-5.4-proOpenAI——
gpt-5.5OpenAI1M工具
gpt-5.5-proOpenAI1M工具
gpt-5.6-lunaOpenAI256K工具多源
gpt-5.6-solOpenAI1M工具多源
gpt-5.6-terraOpenAI1M工具多源
gpt-6-astra-proOpenAI512K视觉 · 工具免费
gpt-6-lunaOpenAI1M工具
gpt-6-solOpenAI——
gpt-6.1-solOpenAI1M视觉 · 工具
gpt-6.1-terraOpenAI1M工具
gpt-6.1-terra-proOpenAI1M视觉 · 工具
text-embedding-3-largeOpenAI——
claude-fable-5Anthropic1M工具
claude-fable-5.1Anthropic1M视觉 · 工具
claude-haiku-5.5Anthropic1M视觉 · 工具
claude-opus-4-7-highAnthropic—视觉
claude-opus-4-8Anthropic1M视觉 · 工具
claude-opus-4.5Anthropic1M工具
claude-opus-4.6Anthropic1M工具多源
claude-opus-4.7Anthropic1M视觉 · 工具多源
claude-opus-4.8Anthropic200K工具
claude-opus-5Anthropic256K工具
claude-opus-5.5Anthropic1M视觉 · 工具
claude-sonnet-4.5Anthropic128K工具多源
claude-sonnet-4.6Anthropic1M工具
claude-sonnet-5Anthropic256K视觉 · 工具
claude-sonnet-5.5Anthropic1M视觉 · 工具
gemini-2.5-flash-liteGoogle256K工具
gemini-2.5-proGoogle256K视觉 · 工具多源
gemini-2.5-pro-previewGoogle1M工具免费
gemini-3.1-flash-liteGoogle1M视觉 · 工具
gemini-3.1-pro-previewGoogle1M视觉 · 工具多源
gemini-3.5-flashGoogle1M视觉 · 工具
gemini-3.6-flashGoogle1M工具
gemini-3.8-flashGoogle256K视觉 · 工具
gemini-4-argonGoogle256K视觉 · 工具
gemini-omni-1.2-flashGoogle128K视觉 · 工具多源
gemma4-26b-a4bGoogle256K工具
Qwen3.8Qwen——
Qwen3.8-FlashQwen——
glm-5.2Zhipu1M工具
glm-5.3Zhipu1M工具多源
glm-5.3-flashZhipu1M工具多源
deepseek-v4.1-flash-1017DeepSeek1M视觉 · 工具
DeepSeek-V4.1-Flash-1017DeepSeek1M视觉 · 工具别名
kimi-k3.1-proMoonshot1M视觉 · 工具
step-5-previewStepFun1M视觉 · 工具

上下文与能力按各模型实际承载的上游实现标注,可能随上游调整,以实际返回为准。

模型价格

以下价格按网关当前计费倍率换算,单位为 美元 / 百万 token;人民币按 1 USD = 7 CNY 换算,仅供对账参考。

模型输入 $/M输出 $/M人民币参考(输入 / 输出)
gpt-3.5-turbo0.501.50¥3.50 / ¥10.50
gpt-5-mini0.030.13¥0.21 / ¥0.91
gpt-5.2-chat免费 FREE 档 · 分组倍率 0
gpt-5.3-codex0.954.00¥6.65 / ¥28.00
gpt-5.4-mini0.150.60¥1.05 / ¥4.20
gpt-5.4-pro30.00180.00¥210.00 / ¥1260.00
gpt-5.50.150.60¥1.05 / ¥4.20
gpt-5.5-pro0.661.98¥4.62 / ¥13.86
gpt-5.6-luna0.070.20¥0.49 / ¥1.40
gpt-5.6-sol0.150.60¥1.05 / ¥4.20
gpt-5.6-terra0.602.40¥4.20 / ¥16.80
gpt-6-astra-pro免费
gpt-6-luna2.507.50¥17.50 / ¥52.50
gpt-6-sol1.504.50¥10.50 / ¥31.50
gpt-6.1-sol2.006.00¥14.00 / ¥42.00
gpt-6.1-terra1.404.40¥9.80 / ¥30.80
gpt-6.1-terra-pro3.0015.00¥21.00 / ¥105.00
text-embedding-3-large0.130.13¥0.91 / ¥0.91
claude-fable-510.0050.00¥70.00 / ¥350.00
claude-fable-5.10.140.28¥0.98 / ¥1.96
claude-haiku-5.50.371.25¥2.59 / ¥8.75
claude-opus-4-7-high5.0020.00¥35.00 / ¥140.00
claude-opus-4-80.422.12¥2.98 / ¥14.88
claude-opus-4.51.203.60¥8.40 / ¥25.20
claude-opus-4.60.150.50¥1.05 / ¥3.50
claude-opus-4.71.002.70¥7.00 / ¥18.90
claude-opus-4.81.404.40¥9.80 / ¥30.80
claude-opus-55.0025.00¥35.00 / ¥175.00
claude-opus-5.50.151.88¥1.05 / ¥13.12
claude-sonnet-4.50.301.20¥2.10 / ¥8.40
claude-sonnet-4.60.150.50¥1.05 / ¥3.50
claude-sonnet-50.954.00¥6.65 / ¥28.00
claude-sonnet-5.50.430.87¥3.04 / ¥6.09
gemini-2.5-flash-lite0.0860.14¥0.60 / ¥1.00
gemini-2.5-pro0.100.40¥0.70 / ¥2.80
gemini-2.5-pro-preview免费
gemini-3.1-flash-lite0.150.47¥1.05 / ¥3.29
gemini-3.1-pro-preview0.150.50¥1.05 / ¥3.50
gemini-3.5-flash0.030.13¥0.21 / ¥0.91
gemini-3.6-flash0.301.20¥2.10 / ¥8.40
gemini-3.8-flash0.432.14¥3.01 / ¥14.98
gemini-4-argon0.864.29¥6.02 / ¥30.03
gemini-omni-1.2-flash0.200.40¥1.40 / ¥2.80
gemma4-26b-a4b0.090.27¥0.63 / ¥1.89
Qwen3.8免费 FREE 档 · 分组倍率 0
Qwen3.8-Flash免费 FREE 档 · 分组倍率 0
glm-5.21.404.40¥9.80 / ¥30.80
glm-5.31.404.40¥9.80 / ¥30.80
glm-5.3-flash0.150.50¥1.05 / ¥3.50
deepseek-v4.1-flash-10170.150.60¥1.05 / ¥4.20
DeepSeek-V4.1-Flash-10170.150.60¥1.05 / ¥4.20
kimi-k3.1-pro0.583.05¥4.08 / ¥21.35
step-5-preview0.300.81¥2.10 / ¥5.67
i
实际扣费以控制台使用的美元额度为准,倍率与上表一一对应。全部 53 个模型价格见 控制台 · 模型广场。免费池共 53 个模型,均在上表标「免费」,其余为按倍率计费模型。

错误码

HTTP含义处理建议
401密钥无效或已禁用检查 Authorization 是否正确、Token 是否启用
400请求参数错误检查模型名、消息格式与 JSON 结构
404模型不存在请求 /v1/models 确认可用 ID
429请求过于频繁降低并发或稍后重试
503无可用渠道该模型暂时不可用,稍后重试或联系管理员

错误响应格式:

json
{
  "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 中。