接入第三方软件
在 Cherry Studio、TRAE、Cursor 这类软件里使用 VibeAPI:地址、令牌、模型 ID、上下文窗口和能力开关怎么填,各软件用哪种格式,报错怎么处理。
在软件里使用 VibeAPI 不需要写代码,把设置页的几个空填对就行。
最快的做法是打开控制台的「接入软件」页:选好软件和模型,每个空的答案都列好了,可以逐项复制,部分软件能一键导入。本页讲这些空是什么意思,以及页面上没有列出的软件怎么填。
要填什么
| 软件里的名字 | 填什么 |
|---|---|
| Base URL、API 地址 | 下方的地址,按格式选一条 |
| API Key、API 密钥 | 控制台「令牌」页复制的令牌 |
| 模型、模型 ID | 模型广场或下方模型参数里的名字,一字不差 |
| 上下文窗口 | 下方模型参数里的数字 |
| 视觉、工具、推理等开关 | 按模型参数打开或关闭 |
OpenAI 格式的地址带 /v1:
https://www.vibeapi.cn/v1Anthropic 格式的地址不带 /v1:
https://www.vibeapi.cn填错了也能通,网关会转到正确的接口。
第一次接入先看这些
选 OpenAI 格式,是不是只能用 GPT?
不是。格式只决定软件怎么和网关通信,和模型是谁家的无关。选 OpenAI 格式,一样能用 Claude、Gemini、DeepSeek 等模型。
那什么时候选 Anthropic 格式?
用 Claude 模型,而且软件有这个选项时。思考过程和缓存走 Claude 自己的协议,效果更完整。软件没有这个选项,选 OpenAI 格式就行。
Base URL 是什么?
软件把请求发到哪里。官方地址换成本站地址,软件就会走本站。
API Key 是什么?
就是令牌,相当于账号密码,用量都算在它头上。不要发给别人。
模型 ID 能随便填吗?
不能。它告诉网关用哪个模型,要和模型广场里的名字一字不差。
上下文窗口是什么?
模型一次能读多少内容。软件不知道这个数时会按很小的值算,长对话就会丢内容,所以有这一项就照着填。
图片、工具、思考这些开关有什么用?
软件靠它们判断模型会什么。没打开时,软件不会发图,也不会调用工具,看起来就像模型不行。
各软件用哪种格式
| 软件 | 格式 | 地址 | 注意 |
|---|---|---|---|
| RikkaHub | OpenAI | 带 /v1 | 手动添加模型时,打开能力开关 |
| Chatbox | OpenAI | 不带 /v1 | API Path 留空;工具调用在模型设置里打开 |
| Cherry Studio | OpenAI、Anthropic | OpenAI 带 /v1,Anthropic 不带 | 添加两个提供商:OpenAI 格式放 GPT 和国产模型,Anthropic 格式放 Claude |
| LobeHub | OpenAI | 不带 /v1 | |
| Open WebUI | OpenAI | 带 /v1 | 在管理面板的外部连接里添加 |
| NextChat | OpenAI | 不带 /v1 | 地址不要带 /v1 |
| AnythingLLM | OpenAI | 带 /v1 | 窗口不填时只有 4096,长对话会丢内容 |
| AionUI | OpenAI | 不带 /v1 | |
| TRAE | Anthropic、OpenAI | OpenAI 带 /v1,Anthropic 不带 | 选 GPT 或国产模型时,API 格式改成 OpenAI |
| Cursor | OpenAI | 带 /v1 | 打开覆盖地址后,所有模型都走这个地址 |
| Cline | OpenAI | 带 /v1 | 窗口不填时按 128000 压缩上下文 |
| Kilo Code | OpenAI | 带 /v1 | 上下文窗口要写在 kilo.jsonc 里 |
| Continue | OpenAI | 带 /v1 | 窗口不填时按 32768 压缩,输出最多 4096 |
| Zed | Anthropic、OpenAI | OpenAI 带 /v1,Anthropic 不带 | max_tokens 在 Zed 里指窗口大小,必须填 |
| CC Switch | Anthropic、OpenAI | OpenAI 带 /v1,Anthropic 不带 | 配 Claude Code 用 Anthropic 地址,配 Codex 用 OpenAI 地址 |
| Gemini CLI | Gemini | 不带 /v1 | 只能用 Gemini 模型 |
| Dify | OpenAI | 带 /v1 | 安装 OpenAI-API-compatible 插件;窗口不填时只有 4096 |
这些填法来自各软件的官方文档和源码,软件改版后名称可能不同。上表没有的软件,先找 OpenAI 兼容或自定义提供商,按 OpenAI 格式填。
编码工具一键配置
下面 8 个工具不用手动填,VibeCLI 一条命令就能配好。先安装 VibeCLI,再运行:
vibecli setup --key sk-xxx命令按令牌能用的模型配置工具,把 sk-xxx 换成你的令牌。只配某一个工具,用表里的命令。
| 工具 | 单独配置 | setup 什么时候配置 |
|---|---|---|
| Claude Code | vibecli config claude-code | 令牌能用 Claude 模型 |
| Claude Desktop | vibecli config claude-desktop | 令牌能用 Claude 模型 |
| Codex(命令行和桌面版) | vibecli config codex | 令牌能用 GPT 模型 |
| Grok Build | vibecli config grok | 令牌能用 Grok 模型 |
| Antigravity CLI | vibecli config agy | 令牌能用 Gemini 模型 |
| WorkBuddy | vibecli config workbuddy | 检测到已安装 |
| CodeBuddy Code | vibecli config codebuddy | 检测到已安装 |
| DeepSeek Harness | vibecli config dsh | 检测到已安装,并确认配置 |
常见问题
| 现象 | 原因 | 怎么办 |
|---|---|---|
| 提示模型不存在或已下架 | 模型 ID 写错,或这个模型已下线 | 从模型广场复制模型名 |
| 提示模型不能用于对话 | 把图像或视频模型配到了对话里 | 换成下方模型参数里的对话模型 |
| 提示令牌无效 | 令牌复制不全,或还是占位值 | 从「令牌」页重新复制,确认没有多余空格 |
| 长对话丢内容 | 上下文窗口没填,软件按很小的默认值压缩 | 填上模型的上下文窗口 |
| 不发图、不调用工具、看不到思考过程 | 软件里对应的开关没打开 | 按模型参数打开开关 |
模型参数
下表只列对话模型。图片、工具、思考三列是软件里的开关:✓ 打开,✗ 关闭。
更新于 2026-11-07
| 模型 ID | 上下文窗口 | 最大输出 | 图片 | 工具 | 思考 | 可用格式 |
|---|---|---|---|---|---|---|
claude-fable-5 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-fable-5-1 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-haiku-4-5-20251001 | 200000 | 64000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-haiku-5-5 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-opus-4-6 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-opus-4-7 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-opus-4-8 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-opus-5 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-opus-5-5 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-sonnet-4-6 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-sonnet-5 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
claude-sonnet-5-5 | 1000000 | 128000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
deepseek-v4-flash | 1000000 | 393216 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
deepseek-v4-pro | 1000000 | 393216 | ✗ | ✓ | ✓ | Anthropic、OpenAI |
deepseek-v4.1-flash | 1000000 | 384000 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
deepseek-v4.1-flash-1017 | 1048576 | 384000 | ✓ | ✓ | ✓ | OpenAI、Anthropic |
gemini-3-flash | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3-pro | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3-pro-image | 65536 | 32768 | ✓ | ✗ | ✓ | Gemini、OpenAI |
gemini-3-pro-image-preview | 65536 | 32768 | ✓ | ✗ | ✓ | Gemini、OpenAI |
gemini-3.1-flash-image | 131072 | 32768 | ✓ | ✗ | ✓ | Gemini、OpenAI |
gemini-3.1-flash-image-preview | 131072 | 32768 | ✓ | ✗ | ✓ | Gemini、OpenAI |
gemini-3.1-flash-lite-image | 65536 | 4096 | ✓ | ✗ | ✓ | Gemini、OpenAI |
gemini-3.1-flash-lite-preview | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3.1-pro | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3.1-pro-preview | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3.5-flash | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3.6-flash | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3.7-flash | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-3.8-flash | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-4-argon | 1048576 | 65536 | ✓ | ✓ | ✓ | Gemini、OpenAI |
gemini-nano-banana-2.1 | 131072 | 32768 | ✓ | ✗ | ✓ | Gemini、OpenAI |
MiniMax-M3 | 1000000 | 524288 | ✓ | ✓ | ✓ | OpenAI、Gemini |
kimi-k3 | 1048576 | 1048576 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
kimi-k3.1-pro | 1048576 | 1048576 | ✓ | ✓ | ✓ | OpenAI、Anthropic |
codex-auto-review | 272000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-5.6-luna | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-5.6-sol | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-5.6-terra | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-6-astra | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-6-luna | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-6-sol | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-6.1-sol | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
gpt-6.1-terra | 1050000 | 128000 | ✓ | ✓ | ✓ | OpenAI |
grok-4.6 | 500000 | 500000 | ✓ | ✓ | ✓ | OpenAI |
grok-4.7 | 500000 | 500000 | ✓ | ✓ | ✓ | OpenAI |
mimo-v2.6-flash | 1048576 | 131072 | ✓ | ✓ | ✓ | OpenAI、Anthropic |
mimo-v2.6-pro | 1048576 | 131072 | ✓ | ✓ | ✓ | OpenAI、Anthropic |
glm-5.2 | 1000000 | 131072 | ✗ | ✓ | ✓ | Anthropic、OpenAI |
glm-5.3 | 1000000 | 131072 | ✗ | ✓ | ✓ | Anthropic、OpenAI |
glm-5.3-flash | 1000000 | 131072 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
hy4-preview | 1000000 | — | ✗ | ✓ | ✓ | OpenAI |
qwen3.7-max | 1000000 | 131072 | ✗ | ✓ | ✓ | Anthropic、OpenAI |
qwen3.7-plus | 1000000 | 131072 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
qwen3.8-flash | 1000000 | 131072 | ✓ | ✓ | ✓ | OpenAI |
qwen3.8-max | 1000000 | 131072 | ✓ | ✓ | ✓ | Anthropic、OpenAI |
最后更新于