TypingMind

Models → Add custom model：填写完整 Endpoint URL https://api.kunavo.com/v1/chat/completions、包含 Bearer 和密钥的 Authorization 标头、Model ID 及其上下文长度 — 每个模型添加一条，直接从浏览器调用。

Models  →  Add custom model  →  Create Manually

Name                    Kunavo · Claude Sonnet 5
Model ID                claude-sonnet-5
Context Length          1000000

Authentication tab
  API Type              OpenAI Chat Completions API
  Endpoint URL          https://api.kunavo.com/v1/chat/completions
  Authentication Type   API Key via HTTP Header
    Header Key          Authorization
    Header Value        Bearer sk-kn-...

Capabilities tab        tick only what you have checked (see below)
Request Options tab     leave "Route requests via TypingMind Cloud" off

                        → Test & Save

分步操作

1. 在 /app/keys 创建密钥并复制——它只会显示一次。
2. 在 TypingMind 中，打开左侧边栏中的 Models，然后点击 Add custom model。保留在 Create Manually；Import JSON 和 Import OpenRouter 用于其他来源。
3. 填写 Name（任意名称）、Model ID（必须与 GET /v1/models 列出的完全一致，例如 claude-sonnet-5）和 Context Length。表单会预填 128000；请根据 模型页面填写模型的实际上下文窗口，因为 TypingMind 会使用这个数字来决定发送多少历史记录。
4. 在 Authentication 标签页中，选择 API Type = OpenAI Chat Completions API，粘贴完整的 Endpoint URL，将 Authentication Type 设为 API Key via HTTP Header，并在 Header Key 中填写 Authorization，在 Header Value 中填写 Bearer sk-kn-... ——即单词 Bearer、一个空格，然后是密钥。
5. 在 功能 中，手动勾选所需功能，或保持开启 保存时自动检查功能——表单说明，保存时会发送“几条测试请求”，这会产生少量 Token 费用。你还可以选择在 价格中填写下方表格列出的每百万 Token 费率，使 TypingMind 的成本显示与你的账单一致。然后点击 测试并保存。
6. 每个模型都要重复上述操作。自定义端点没有提供商级别的条目：Claude Sonnet、Claude Haiku 和一个 GPT 模型是三个独立的自定义模型，但它们使用相同的 Endpoint URL 和请求头。

已于 2026年10月1日 对照 TypingMind 模型文档 检查。第三方设置会发生变化；如果这里的字段名称不再与你看到的内容一致，应以该页面为准，而不是本页。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON，则相同的基础 URL 和密钥可以在 TypingMind 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models，包含价格的目录见模型页面。费率单位为每 1M token 的美元，格式为输入 / 输出。

另外三种 API 类型

在线表单中的 API Type 下拉菜单提供 OpenAI Chat Completions API、OpenAI Responses API、Claude Messages API 和 Gemini API。Kunavo 支持前三种；每种都需要在 Endpoint URL 中填写完整路由。

• Claude Messages API —— Endpoint URL https://api.kunavo.com/v1/messages。TypingMind 自带的 Claude 格式示例使用 x-api-key 请求头；Kunavo 在此路由上同时接受该请求头和 Authorization: Bearer。此路由仅提供 Claude 系列模型 id。
• OpenAI Responses API —— Endpoint URL https://api.kunavo.com/v1/responses，使用相同的 Bearer 请求头。TypingMind 的文档没有提供这种类型的完整示例，因此完整路由的写法是根据另外三种类型推断得出的，并非文档原文。
• Gemini API —— 不适用于此端点。它需要 Google 原生请求格式；请改用 Chat Completions 类型调用 Gemini 模型。

这不是 TypingMind API

“TypingMind API”通常指 TypingMind Teams 实例（custom.typingmind.com）的 REST API，用于管理该聊天实例。它不出售模型 Token，也与此配置无关。自定义模型只是 TypingMind 使用你提供的密钥调用其他人的端点。

两笔独立账单

TypingMind 许可证用于支付应用费用。你通过自定义模型发送的每条消息，都会由请求头中的密钥持有者按 token 计费；在此场景中，密钥持有者是 Kunavo，费用从预付余额中扣除。许可证档位以及按这些费率计算一个月聊天的费用，详见 TypingMind 定价与 API 成本。

Test & Save 失败时

• 404，提示“POST /v1 is the base URL, not an endpoint”（或者 URL 只到主机时提示“Not found: /”）——Endpoint URL 缺少路由。它必须以 /v1/chat/completions 结尾（对应的类型则以 /v1/messages、/v1/responses 结尾）。2026 年 10 月 1 日之前，两种情况都会返回 HTML 页面。
• 404，提示“没有此端点” — 路由拼写错误，例如 /v1/chat/completion。同一消息会指出 Kunavo 提供的最接近路由。
• 404，提示“Not found: /chat/completions. Kunavo's API lives under /v1” — 路由存在，但缺少 /v1：Endpoint URL 填写的是 https://api.kunavo.com/chat/completions。请在路由前添加 /v1。（于 2026 年 10 月 1 日检查；在此日期之前，同样的错误会返回 HTML 页面。）
• 401“缺少或无效的 API 密钥” — 标头有误：Header Key 必须为 Authorization，值必须以 Bearer 开头，或者该密钥已被撤销。
• 模型不可用错误 ——Model ID 的拼写与 GET /v1/models 列出的不一致。ID 使用小写字母和连字符。
• 浏览器控制台中出现网络或 CORS 错误 ——请确认 Endpoint URL 填写的是 https://api.kunavo.com，而不是网站域名；发送 CORS 请求头的是 API 主机。