登录注册
开发者文档

接入第三方软件

在 Cherry Studio、TRAE、Cursor 这类软件里使用 VibeAPI:地址、令牌、模型 ID、上下文窗口和能力开关怎么填,各软件用哪种格式,报错怎么处理。

在软件里使用 VibeAPI 不需要写代码,把设置页的几个空填对就行。

最快的做法是打开控制台的「接入软件」页:选好软件和模型,每个空的答案都列好了,可以逐项复制,部分软件能一键导入。本页讲这些空是什么意思,以及页面上没有列出的软件怎么填。

要填什么

软件里的名字填什么
Base URL、API 地址下方的地址,按格式选一条
API Key、API 密钥控制台「令牌」页复制的令牌
模型、模型 ID模型广场或下方模型参数里的名字,一字不差
上下文窗口下方模型参数里的数字
视觉、工具、推理等开关按模型参数打开或关闭

OpenAI 格式的地址带 /v1:

https://www.vibeapi.cn/v1

Anthropic 格式的地址不带 /v1:

https://www.vibeapi.cn

填错了也能通,网关会转到正确的接口。

第一次接入先看这些

选 OpenAI 格式,是不是只能用 GPT?

不是。格式只决定软件怎么和网关通信,和模型是谁家的无关。选 OpenAI 格式,一样能用 Claude、Gemini、DeepSeek 等模型。

那什么时候选 Anthropic 格式?

用 Claude 模型,而且软件有这个选项时。思考过程和缓存走 Claude 自己的协议,效果更完整。软件没有这个选项,选 OpenAI 格式就行。

Base URL 是什么?

软件把请求发到哪里。官方地址换成本站地址,软件就会走本站。

API Key 是什么?

就是令牌,相当于账号密码,用量都算在它头上。不要发给别人。

模型 ID 能随便填吗?

不能。它告诉网关用哪个模型,要和模型广场里的名字一字不差。

上下文窗口是什么?

模型一次能读多少内容。软件不知道这个数时会按很小的值算,长对话就会丢内容,所以有这一项就照着填。

图片、工具、思考这些开关有什么用?

软件靠它们判断模型会什么。没打开时,软件不会发图,也不会调用工具,看起来就像模型不行。

各软件用哪种格式

软件格式地址注意
RikkaHubOpenAI带 /v1手动添加模型时,打开能力开关
ChatboxOpenAI不带 /v1API Path 留空;工具调用在模型设置里打开
Cherry StudioOpenAI、AnthropicOpenAI 带 /v1,Anthropic 不带添加两个提供商:OpenAI 格式放 GPT 和国产模型,Anthropic 格式放 Claude
LobeHubOpenAI不带 /v1
Open WebUIOpenAI带 /v1在管理面板的外部连接里添加
NextChatOpenAI不带 /v1地址不要带 /v1
AnythingLLMOpenAI带 /v1窗口不填时只有 4096,长对话会丢内容
AionUIOpenAI不带 /v1
TRAEAnthropic、OpenAIOpenAI 带 /v1,Anthropic 不带选 GPT 或国产模型时,API 格式改成 OpenAI
CursorOpenAI带 /v1打开覆盖地址后,所有模型都走这个地址
ClineOpenAI带 /v1窗口不填时按 128000 压缩上下文
Kilo CodeOpenAI带 /v1上下文窗口要写在 kilo.jsonc 里
ContinueOpenAI带 /v1窗口不填时按 32768 压缩,输出最多 4096
ZedAnthropic、OpenAIOpenAI 带 /v1,Anthropic 不带max_tokens 在 Zed 里指窗口大小,必须填
CC SwitchAnthropic、OpenAIOpenAI 带 /v1,Anthropic 不带配 Claude Code 用 Anthropic 地址,配 Codex 用 OpenAI 地址
Gemini CLIGemini不带 /v1只能用 Gemini 模型
DifyOpenAI带 /v1安装 OpenAI-API-compatible 插件;窗口不填时只有 4096

这些填法来自各软件的官方文档和源码,软件改版后名称可能不同。上表没有的软件,先找 OpenAI 兼容或自定义提供商,按 OpenAI 格式填。

编码工具一键配置

下面 8 个工具不用手动填,VibeCLI 一条命令就能配好。先安装 VibeCLI,再运行:

vibecli setup --key sk-xxx

命令按令牌能用的模型配置工具,把 sk-xxx 换成你的令牌。只配某一个工具,用表里的命令。

工具单独配置setup 什么时候配置
Claude Codevibecli config claude-code令牌能用 Claude 模型
Claude Desktopvibecli config claude-desktop令牌能用 Claude 模型
Codex(命令行和桌面版)vibecli config codex令牌能用 GPT 模型
Grok Buildvibecli config grok令牌能用 Grok 模型
Antigravity CLIvibecli config agy令牌能用 Gemini 模型
WorkBuddyvibecli config workbuddy检测到已安装
CodeBuddy Codevibecli config codebuddy检测到已安装
DeepSeek Harnessvibecli config dsh检测到已安装,并确认配置

常见问题

现象原因怎么办
提示模型不存在或已下架模型 ID 写错,或这个模型已下线从模型广场复制模型名
提示模型不能用于对话把图像或视频模型配到了对话里换成下方模型参数里的对话模型
提示令牌无效令牌复制不全,或还是占位值从「令牌」页重新复制,确认没有多余空格
长对话丢内容上下文窗口没填,软件按很小的默认值压缩填上模型的上下文窗口
不发图、不调用工具、看不到思考过程软件里对应的开关没打开按模型参数打开开关

模型参数

下表只列对话模型。图片、工具、思考三列是软件里的开关:✓ 打开,✗ 关闭。

更新于 2026-11-07

模型 ID上下文窗口最大输出图片工具思考可用格式
claude-fable-51000000128000✓✓✓Anthropic、OpenAI
claude-fable-5-11000000128000✓✓✓Anthropic、OpenAI
claude-haiku-4-5-2025100120000064000✓✓✓Anthropic、OpenAI
claude-haiku-5-51000000128000✓✓✓Anthropic、OpenAI
claude-opus-4-61000000128000✓✓✓Anthropic、OpenAI
claude-opus-4-71000000128000✓✓✓Anthropic、OpenAI
claude-opus-4-81000000128000✓✓✓Anthropic、OpenAI
claude-opus-51000000128000✓✓✓Anthropic、OpenAI
claude-opus-5-51000000128000✓✓✓Anthropic、OpenAI
claude-sonnet-4-61000000128000✓✓✓Anthropic、OpenAI
claude-sonnet-51000000128000✓✓✓Anthropic、OpenAI
claude-sonnet-5-51000000128000✓✓✓Anthropic、OpenAI
deepseek-v4-flash1000000393216✓✓✓Anthropic、OpenAI
deepseek-v4-pro1000000393216✗✓✓Anthropic、OpenAI
deepseek-v4.1-flash1000000384000✓✓✓Anthropic、OpenAI
deepseek-v4.1-flash-10171048576384000✓✓✓OpenAI、Anthropic
gemini-3-flash104857665536✓✓✓Gemini、OpenAI
gemini-3-pro104857665536✓✓✓Gemini、OpenAI
gemini-3-pro-image6553632768✓✗✓Gemini、OpenAI
gemini-3-pro-image-preview6553632768✓✗✓Gemini、OpenAI
gemini-3.1-flash-image13107232768✓✗✓Gemini、OpenAI
gemini-3.1-flash-image-preview13107232768✓✗✓Gemini、OpenAI
gemini-3.1-flash-lite-image655364096✓✗✓Gemini、OpenAI
gemini-3.1-flash-lite-preview104857665536✓✓✓Gemini、OpenAI
gemini-3.1-pro104857665536✓✓✓Gemini、OpenAI
gemini-3.1-pro-preview104857665536✓✓✓Gemini、OpenAI
gemini-3.5-flash104857665536✓✓✓Gemini、OpenAI
gemini-3.6-flash104857665536✓✓✓Gemini、OpenAI
gemini-3.7-flash104857665536✓✓✓Gemini、OpenAI
gemini-3.8-flash104857665536✓✓✓Gemini、OpenAI
gemini-4-argon104857665536✓✓✓Gemini、OpenAI
gemini-nano-banana-2.113107232768✓✗✓Gemini、OpenAI
MiniMax-M31000000524288✓✓✓OpenAI、Gemini
kimi-k310485761048576✓✓✓Anthropic、OpenAI
kimi-k3.1-pro10485761048576✓✓✓OpenAI、Anthropic
codex-auto-review272000128000✓✓✓OpenAI
gpt-5.6-luna1050000128000✓✓✓OpenAI
gpt-5.6-sol1050000128000✓✓✓OpenAI
gpt-5.6-terra1050000128000✓✓✓OpenAI
gpt-6-astra1050000128000✓✓✓OpenAI
gpt-6-luna1050000128000✓✓✓OpenAI
gpt-6-sol1050000128000✓✓✓OpenAI
gpt-6.1-sol1050000128000✓✓✓OpenAI
gpt-6.1-terra1050000128000✓✓✓OpenAI
grok-4.6500000500000✓✓✓OpenAI
grok-4.7500000500000✓✓✓OpenAI
mimo-v2.6-flash1048576131072✓✓✓OpenAI、Anthropic
mimo-v2.6-pro1048576131072✓✓✓OpenAI、Anthropic
glm-5.21000000131072✗✓✓Anthropic、OpenAI
glm-5.31000000131072✗✓✓Anthropic、OpenAI
glm-5.3-flash1000000131072✓✓✓Anthropic、OpenAI
hy4-preview1000000—✗✓✓OpenAI
qwen3.7-max1000000131072✗✓✓Anthropic、OpenAI
qwen3.7-plus1000000131072✓✓✓Anthropic、OpenAI
qwen3.8-flash1000000131072✓✓✓OpenAI
qwen3.8-max1000000131072✓✓✓Anthropic、OpenAI

最后更新于