客户端接入
第三方客户端与积木桌面端的接入指南——base_url 配置、鉴权方式、常见问题，以及积木客户端的一键鉴权。
客户端接入积木分为两种方式：使用现有第三方客户端直连，或安装积木官方桌面端。
第三方客户端
任何兼容 OpenAI / Anthropic / Gemini 协议的第三方客户端都能接入积木：把服务地址指向积木、填入令牌即可。关键是每种客户端生态的 base_url 填法不同。
base_url 对照
| 客户端生态 | base_url 填 | 说明 |
|---|---|---|
| OpenAI 兼容客户端（Cherry Studio、NextChat 等） | https://api.jimu.chat/v1 | 客户端会自动拼 /chat/completions 等路径 |
| OpenAI SDK（Python / Node） | https://api.jimu.chat/v1 | 构造参数 base_url / baseURL |
| Anthropic SDK / Claude 生态 | https://api.jimu.chat | SDK 自动拼 /v1/messages，不要自己加 /v1 |
| Google genai SDK | https://api.jimu.chat | SDK 自动拼 /v1beta/models/...，不要自己加路径 |
鉴权统一填你的 sk- 令牌：OpenAI 生态放 Authorization: Bearer，
Anthropic 生态放 x-api-key，Gemini 生态放 x-goog-api-key 或 ?key=。
详见 鉴权与令牌。
/v1。 OpenAI 生态必须带 /v1，
Anthropic 与 Gemini 生态必须不带。连不上时先核对上表。模型名怎么填
客户端里的模型下拉或手填项，必须填令牌实际可用的模型 ID。 模型列表随账号变化，不要照抄任何静态清单，用接口查实时列表：
curl https://api.jimu.chat/v2/models \
-H "Authorization: Bearer $JIMU_API_KEY"
返回字段与能力标签含义见 模型列表。
常见问题
客户端显示「连接失败」或 404
「连接失败」说明请求没有到达平台——先检查网络连通性与地址拼写。
请求到达平台但路径未注册时，平台返回 404，错误信息为 Invalid URL (请求方法 路径)。
按上表核对 base_url：OpenAI 兼容客户端漏掉 /v1、Anthropic / Gemini 生态多写了 /v1，都会拼出未注册路径。
提示模型不存在或无权限
按返回的错误文案对照成因：
该令牌无权访问模型 <模型名>或该令牌无权访问任何模型（403）：令牌开启了模型限制。在控制台的令牌设置中把该模型加入名单，或清空限制。当前套餐等级 <等级> 暂不支持模型 <模型名>，请切换为当前套餐可用模型或升级套餐（403）：按提示换用套餐内模型，或升级套餐。模型 <模型名> 暂无可用渠道，请稍后再试（503）：平台当前没有可服务该模型的渠道。换用其他模型，或稍后再试。
流式输出不生效
流式由请求本身决定：
- Chat Completions、Responses 与 Anthropic 协议：请求体带
"stream": true。 - Gemini 协议：流式由查询参数
?alt=sse决定——路径写:streamGenerateContent但不带alt=sse时按非流式处理。官方 SDK 的流式调用会自动带上该参数，手写 HTTP 请求最容易漏。
细节见各协议文档的流式章节：Chat Completions、 Responses、 Anthropic Messages、 Gemini generateContent。
客户端模型列表为空
客户端的模型列表来自 GET /v2/models，它只返回你的账号当前实际可用的模型：
- 令牌开启了模型限制时，列表只含名单内的模型——名单为空则列表为空。在控制台的令牌设置中检查模型限制。
- 排除限制设置后列表仍为空，说明账号当前没有可用模型，请联系支持。
积木客户端
平台官方桌面客户端，无需任何网络配置：从 积木官网 下载安装包
（Windows .exe / macOS .dmg），用官网账号登录即可使用，模型列表随账号自动同步。
一键鉴权
桌面端不需要手动填 base_url，也不需要自己创建和粘贴 sk- 令牌。
首次使用时客户端会引导你在浏览器中确认授权，之后凭据由客户端自行获取、保存与续期，
过期前自动续签，正常使用中不需要再次操作。
与手动配置第三方客户端的差别就在这里：手动方式由你自己提供 base_url 与令牌并自行管理， 桌面端把这一步交给客户端完成。