供应商配置在 <CETAS_HOME>/.cetas/settings.json 的 providers 下。Cetas 提供配置与凭据来源;端点、协议细节、模型能力、登录行为,都由各自的供应商扩展自己负责。
内置供应商
下面这些 id 由内核注册。它们同时也是你传给 /login 的 id,以及 provider/model 槽位的前半段。
| Id | 供应商 | 登录方式 |
|---|---|---|
deepseek |
DeepSeek | API key |
kimi |
Kimi | API key、OAuth |
openai |
OpenAI | API key、OAuth |
opencode |
OpenCode Zen | API key |
opencode-go |
OpenCode Go | OAuth |
zai |
Z.ai | API key |
zai-coding-plan |
Z.ai Coding Plan | API key |
openrouter |
OpenRouter | API key |
typesafe |
Typesafe jev 决策后端 |
API key |
拥有多种登录方式的供应商会出现方式选择器;只有一种的会跳过选择器,直接要凭据。
供应商 id 的规则
id 只允许字母、数字、_ 和 -,因为它同时出现在 settings key、凭据文件名和登录目标里。
opencode 这个 id 归 OpenCode Zen,所以 providers.opencode 会解析到 Zen,而不会掉到兼容适配器里。
其他一切走 OpenAI 兼容
providers 里任何既不在上表、也不撞 id 的 key,都会变成一个 OpenAI 兼容供应商。这是网关、代理、以及自家部署的 OpenAI 形状 API 的官方支持路径 —— 见自定义与私有化模型。
因为兼容工厂列表是从 settings 现算的,自定义供应商和内置供应商享受完全一样的待遇:/login、/model、目录刷新、模型缓存都一视同仁。
登录
/login选择器列出的是这一份构建能组合出来的供应商。要登录自定义供应商,对着它的 id 登:
/login my-gateway凭据文件写到 <CETAS_HOME>/.cetas/credentials/,所有入口共用。手边没有终端时,cetas-run --login 也能对 runner 完成同样的事。
关于 schema
不存在一套覆盖所有供应商的通用 JSON schema,本页也不会凭空编造供应商专属的 key。优先用 /login 和 /model;settings 里的供应商段落由各扩展自己解释。私有端点这类简单的条目形状,写在自定义模型里。