五猫 API 使用文档：新手快速开始
本文介绍五猫 API 的基础使用流程，包括注册账号、创建 API Key、配置 Base URL、选择模型和接入第三方客户端，适合第一次使用的新用户阅读。
五猫 API 使用文档：新手快速开始
五猫 API 是一个 AI 模型聚合与中转平台。你可以通过五猫 API 使用多种主流 AI 模型，并将平台生成的 API Key 接入到第三方客户端、开发工具或你自己的程序中。
如果你是第一次使用，不需要一次看完所有教程。先完成下面几个步骤，就可以开始正常调用模型。
推荐阅读顺序
新用户建议按照下面的顺序操作：
- 注册账号
- 创建 API Key
- 配置 API 基础地址
- 选择模型和接入方式
- 查看用量与计费
首次使用流程
1. 注册账号
使用五猫 API 前，需要先注册并登录账号。后续创建 API Key、充值、查看用量、管理令牌都需要在账号后台完成。
建议注册完成后，先进入控制台熟悉一下账户余额、令牌管理和日志页面。
2. 创建 API Key
API Key 是客户端或开发工具调用模型时使用的身份凭证。
你可以把它理解成“调用接口的密码”。接入 ChatBox、Cherry Studio、Open WebUI、Codex、Claude Code 等工具时，通常都需要填写 API Key。
请注意：
- 不要把 API Key 发给陌生人
- 不要把 API Key 上传到 GitHub
- 不要在公开截图里展示完整 API Key
- 如果怀疑泄露，建议立即删除旧 Key 并重新创建
3. 配置 API 基础地址
大多数客户端都需要同时填写两个参数：
“`text
API Key：你在五猫 API 后台创建的令牌
Base URL：https://api.wucat.cc/v1
如果某个客户端要求填写 OpenAI Compatible、OpenAI API、接口地址、API 地址，通常就是填写上面的 Base URL。
4. 选择模型
不同模型适合不同场景。
日常聊天、写作、翻译、总结，可以优先选择速度快、成本低的模型。
代码、复杂推理、长文档分析、智能体任务，可以选择能力更强的模型。
如果你不确定用哪个，可以先从模型广场里查看模型介绍、价格和适用场景，再根据自己的需求选择。
5. 选择接入方式
五猫 API 支持接入多种第三方工具，常见场景如下：
| 使用场景 | 推荐接入方式 |
|---|---|
| 日常聊天 | ChatBox、Cherry Studio、Open WebUI |
| 手机端使用 | 支持 OpenAI Compatible 的移动客户端 |
| 代码辅助 | Codex、Claude Code、Cline |
| 自动化开发 | API / SDK / 脚本调用 |
| 多模型管理 | 支持自定义 Base URL 的客户端 |
如果你只是普通用户，建议先从 ChatBox 或 Cherry Studio 开始，配置简单，适合日常使用。
使用时需要记住的几点
- 五猫 API 按实际使用量计费
- 不同模型的输入价格、输出价格可能不同
- 长对话、长文档、代码工具通常会消耗更多 Token
- 客户端一般需要同时填写 API Key 和 Base URL
- 如果模型调用失败，可以先检查余额、模型名、令牌状态和请求日志
- 如果某个模型响应慢，可以尝试切换其他模型
下一步
如果你是新用户，建议接下来按顺序阅读：
- 注册账号教程
- 创建 API Key 教程
- Base URL 配置说明
- 常用客户端接入教程
- 模型选择与计费说明
完成这些基础配置后，你就可以在常用客户端或开发工具中使用五猫 API 了。
