快速接入 Agent
Cherry Studio
配置步骤
- 新增自定义 Provider,类型选择 OpenAI Compatible 或 OpenAI。
- 如果当前版本要求 OpenAI Base URL,填 https://www.zltokens.com/v1;如果会自动拼接 /v1/chat/completions,则只填 https://www.zltokens.com。
- 模型可通过列表拉取或手动添加平台公开模型名。
- 图片输入是否可用取决于模型能力和管理员是否配置图片价格。
验证方式
- 发送一句短文本,关闭图片、文件和长上下文。
- 排查价格、潮汐 Tokens 或渠道问题时,优先查看 request_id、模型名、token、渠道和错误正文。
验证与排障
- 选择 OpenAI Compatible 或自定义 Provider,避免 Base URL 被拼成
/v1/v1。模型发现失败时手动填写平台公开模型名。 - 首次请求应在使用日志中看到
/v1/chat/completions;没有记录时先停止并检查地址、Key 和客户端协议。
官方版本参考
- 客户端配置会随版本变化;部署、排障或改配置前,请核对 [Cherry Studio Provider settings](https://docs.cherry-ai.com/cherry-studio-wen-dang/en-us/cherry-studio/preview/settings/providers).