快速开始 · 约 5 分钟
从账户到第一次调用， 一步一步完成。
按照“登录账户 → 检查余额 → 确定模型 → 创建 API Key → 配置客户端 → 发送测试请求”的顺序，即可开始使用 OmniDino。
快速开始流程
完成 6 个步骤即可开始调用
01登录账户
02检查余额
03选择模型
04创建 API Key
05配置客户端
06验证调用
完整流程
跟着下面的步骤操作。
不同工具的配置界面不完全相同，但需要准备的账户、余额、API Key、接口地址和模型名称基本一致。
01
02
第二步
检查账户余额
API 调用会根据模型价格和实际使用量扣除账户余额。开始配置前，请先确认账户中有足够余额完成至少一次测试调用。
进入控制台的钱包、充值或余额页面。
确认当前可用余额不是 0。
余额不足时，按页面提供的充值或兑换方式补充余额。
充值完成后刷新页面，确认余额已经更新。
计费提示：不同模型的输入、输出、缓存、图片或其他计费项目可能不同。实际价格以 OmniDino 模型广场和控制台显示为准。
03
04
第四步
创建并复制 API Key
进入控制台的 API Key 或令牌管理页面，为当前工具或项目创建一条独立密钥。建议用清晰的名称标记用途，方便后续统计、停用和排查。
名称
例如 codex-work、claude-code-test 或 cherry-personal。
分组或权限
根据目标模型和实际使用场景选择对应设置。
额度限制
首次测试可设置较小额度，验证可用后再调整。
安全提醒：API Key 应当像密码一样保存。不要放在网页前端、公开代码仓库、截图、论坛或群聊中。若怀疑泄露，请立即删除旧 Key 并重新创建。
05
第五步
填写 Base URL、API Key 和模型名称
大多数客户端需要三项核心信息。接口地址需要按照客户端使用的协议填写，模型名称则以 OmniDino 控制台或模型广场中的实际名称为准。
OpenAI 兼容客户端
https://api.omnidino.com/v1
常用于 Codex、Cherry Studio OpenAI、自研 OpenAI 兼容程序等。
Claude 兼容客户端
https://api.omnidino.com
Claude Code 或 Claude Desktop 通常填写根地址，由客户端生成具体请求路径。
CD
Codex Desktop
桌面端代码 Agent 配置。
CLI
Codex CLI
终端中的 Codex 配置。
CC
Claude Code
Claude 原生协议与代码工具。
G
Gemini CLI
Gemini 命令行工具配置。
CS
Cherry Studio
OpenAI 兼容供应商配置。
SW
CC Switch
集中管理多个 AI 工具配置。
协议提示：不要机械地给所有客户端都添加
/v1。OpenAI 兼容客户端通常使用带 /v1 的地址，Claude 原生客户端通常使用根地址。
06
第六步
发送最小请求，验证配置
在目标客户端中发送一个简单任务，或者使用下面的命令验证 API Key 与接口地址是否可以正常访问。
OpenAI 兼容接口验证
curl https://api.omnidino.com/v1/models \
-H "Authorization: Bearer 粘贴你的APIKey"
Chat Completions 最小请求
curl https://api.omnidino.com/v1/chat/completions \
-H "Authorization: Bearer 粘贴你的APIKey" \
-H "Content-Type: application/json" \
-d '{
"model": "填写控制台中的模型名称",
"messages": [
{
"role": "user",
"content": "Reply with: OmniDino connected"
}
]
}'
验证成功：客户端能够收到模型回复，控制台中出现调用记录或余额变化，即表示基础配置已经完成。
排查问题
请求失败时，按顺序检查。
先检查最常见的配置问题，再判断是否是模型、余额或网络异常。
配置检查顺序
- API Key 是否复制完整，前后是否存在空格。
- Base URL 是否与客户端协议匹配。
- 模型名称是否与控制台中的实际名称完全一致。
- API Key 的分组、权限或额度是否允许访问目标模型。
- 账户余额是否足够完成请求。
- 本地网络是否能够访问 api.omnidino.com。
提交支持请求时
- 提供你的账户邮箱。
- 说明正在配置的工具和系统版本。
- 提供模型名称、接口地址和完整错误信息。
- 可提供隐藏敏感信息后的截图。
- 不要发送账户密码或完整 API Key。
- 支持邮箱：[email protected]。
✓
配置完成，现在可以开始使用 OmniDino。
你已经准备好了账户、余额、API Key、接口地址和模型名称。接下来可以根据目标工具查看对应教程，或使用 CC Switch 管理多个客户端。
继续阅读