← 返回文档首页

快速接入 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).