TypingMind

在 TypingMind 中把 OneProvider 添加为 custom model。TypingMind 需要完整的端点地址，而不是 base URL。

TypingMind 没有 base URL 字段：custom model 表单要求填写完整的端点地址，并原样把请求发送到这个地址，不会追加任何路径。内置的 Claude（Anthropic）API 密钥字段直接连接 Anthropic，因此在 TypingMind 中，OneProvider 密钥只能通过 custom model 使用。

1. 添加 custom model

1. 在 TypingMind 左侧边栏打开 Models，点击 Add custom model，保持选中 Create Manually。
2. Name：任意名称，例如 OneProvider claude-opus-5-5。
3. Model ID：模型页面 上的准确 ID，例如 claude-opus-5-5。显示名称“Claude Opus 5.5”不是 ID。
4. Context Length：同一页面上该模型的上下文窗口。

2. API Type、Endpoint URL 和密钥

在 Authentication 标签页选择以下两种 API 类型之一，并严格按下方内容填写字段。两种类型都使用同一个 OneProvider 密钥。

Claude Messages API（Claude 模型）

API Type: Claude Messages API
Endpoint URL: https://api.oneprovider.dev/v1/messages
Authentication Type: API Key via HTTP Header
Header Key: x-api-key
Header Value: sk-your-key-here
Model ID: claude-opus-5-5

OpenAI Chat Completions API（GPT 和 Claude 模型）

API Type: OpenAI Chat Completions API
Endpoint URL: https://api.oneprovider.dev/v1/chat/completions
Authentication Type: API Key via HTTP Header
Header Key: Authorization
Header Value: Bearer sk-your-key-here
Model ID: gpt-6.1-terra

Header Value 为单词 Bearer、一个空格，然后是完整的密钥。claude-sonnet-5-5 等 Claude ID 在这个路由上同样可用。

3. Temperature 与请求选项

• temperature 保持默认值。Claude 5.x 模型收到非默认 temperature 时会返回 400；如果您在 TypingMind 的模型或聊天设置中改过它，请恢复默认。
• 无需开启 Route requests via TypingMind Cloud：我们的 API 接受直接来自浏览器的请求（CORS）。

4. Test & Save

点击 Test & Save，然后在聊天中选择新模型。

每个模型都是单独的 custom model：为每个需要的 ID 重复以上步骤，Endpoint URL 和密钥保持不变。

如何选择模型

claude-opus-5-5 适合长而复杂的对话，claude-sonnet-5-5 是均衡的默认选择，claude-haiku-5-5 快速且便宜；gpt-6.1-terra 等 GPT 模型使用 OpenAI Chat Completions API 类型。请按照模型页面 上的写法准确填写 ID；价格见价格页面 。

常见错误与解决办法

404 Not Found

Endpoint URL 填的是 base URL（https://api.oneprovider.dev/v1 或 https://api.oneprovider.dev）。Claude Messages API 类型请使用 https://api.oneprovider.dev/v1/messages，OpenAI Chat Completions API 类型请使用 https://api.oneprovider.dev/v1/chat/completions。

找不到模型或模型不可用

Model ID 必须是准确的 ID，例如 claude-opus-5-5，而不是模型的显示名称。请从模型页面 复制。

因 temperature 返回 400

Claude 5.x 模型只接受默认的 temperature。请在 TypingMind 中把 temperature 恢复为默认值，然后重新发送消息。

401 authentication_error

Claude Messages API：Header Key 为 x-api-key，值为完整密钥。OpenAI Chat Completions API：Header Key 为 Authorization，值为 Bearer sk-...。

密钥在 TypingMind 内置的 Claude 字段中无效

该字段把请求发送到 Anthropic，而 Anthropic 不认识 OneProvider 密钥。请按上文把 OneProvider 添加为 custom model。

常见问题

TypingMind 需要 base URL 还是完整端点？

完整端点。TypingMind 不会追加路由，所以地址必须以 /v1/messages 或 /v1/chat/completions 结尾。

需要开启 Route requests via TypingMind Cloud 吗？

不需要。我们的 API 接受来自浏览器的请求（CORS），TypingMind 可以直接调用。

可以使用 GPT 模型吗？

可以：选择 OpenAI Chat Completions API 类型，并填写 gpt-6.1-terra 等 GPT ID。

一个条目能覆盖所有模型吗？

不能。每个模型都是单独的 custom model，使用相同的 Endpoint URL 和密钥。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。