选择账户可用的模型

当客户端要求你填写模型时，真正该填的是模型 ID。最稳妥的做法不是猜名字，而是从你自己账户当前可用的列表里完整复制。

先区分两个名字

名称	作用	能否自己修改
模型 ID	API 用来识别模型的精确值	不能；必须完整复制
显示名称	某些客户端中的本地备注	可以；不会改变实际模型

大小写、斜杠、连字符和后缀都可能是 ID 的一部分。复制时不要删减，也不要把卡片标题或营销名称当成模型 ID。

1. 先看你有哪些选择

打开门户的 定价 页面，可以先看看当前有哪些模型。这里适合做“挑选范围”，不适合直接认定某枚 Token 一定能用哪个模型。

真正和你当前 Token 一一对应的，可用列表要看两处之一：

• 填入 CC Switch 窗口；
• GET /v1/models 的返回结果。

2. 如果你走 CC Switch 路径

在 API 密钥 页面从 Token 行选择 CC Switch 后，填入 CC Switch 窗口会使用当前账户的模型列表。直接从窗口里选一项即可，不需要手工输入网上教程里的示例模型。

导入完成后，在 CC Switch 中确认提供方卡片记录的模型与窗口选择一致。切换模型后，要完全退出并重新打开正在运行的命令行客户端。

3. 如果你要配置其他客户端

使用准备配置的同一枚 Token 请求：

GET https://api.zhiflo.com/v1/models
Authorization: Bearer <YOUR_ZHIFLO_TOKEN>

响应中 data[].id 是这枚 Token 可以使用的模型 ID。复制其中一个完整值，再粘贴到客户端的 Model、Model ID 或主模型字段。完整命令与示例返回见 发送第一次 API 请求。

保存后，客户端的模型选择器应出现相同的完整 ID。若只看到你填写的显示名称，打开提供方设置再次核对实际 Model ID。

4. 选哪个模型最稳妥

先从账户当前可用列表里挑一项适合你任务的模型，再发一条短提示验证。不要依赖博客里的固定推荐，因为可用范围、费用和用量规则都可能变化。

如果客户端提示“模型不存在”或“无权使用”：

1. 重新复制 填入 CC Switch 窗口或 /v1/models 返回的完整 ID；
2. 确认 Token 与查看模型时使用的是同一账户和分组；
3. 保存更正后的模型 ID；
4. 在模型选择器中重新选择该模型；
5. 完全退出并重新打开客户端。

下一步：选择你的 客户端配置指南。