OmniDino
EN / 中文
获取 API Key
首页 模型 价格 教程 关于 联系 登录 获取 API Key
EN 中文

API连接测试

API 诊断台

用最小请求检查 OmniDino 是否连接正常。

先验证接口地址、API Key、模型名称和协议端点，再排查 Codex、Claude Code、Gemini CLI、Cherry Studio 或 Dify 等客户端本身的问题。

开始诊断 打开控制台 查看模型与价格
命令生成器

选择接口和终端，自动生成测试命令。

页面不会发送你的 API Key。命令只在当前浏览器中生成，请不要在公共设备上粘贴真实密钥。

不要在截图、客服邮件、公开仓库或群聊中发送完整 API Key。诊断完成后，可清空本页输入框。
测试命令 
请选择接口并点击“生成命令”。
接口测试

逐项验证不同端点。

先从 Models 接口开始，再测试实际模型端点。这样可以快速判断问题是在网关、密钥、模型还是协议层。

验证网关和 API Key

这是最基础的检查。它能证明域名可访问、请求头格式正确，并且 API Key 能通过基础鉴权。

没有返回 401 Unauthorized。
能够返回模型数据或正常 JSON 响应。
说明网关和 Key 基础连接正常。
Models 测试成功不代表所有模型都能调用。还需要继续验证目标模型、端点类型、余额和令牌权限。
Models 
curl https://api.omnidino.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Chat Completions

常用于普通 OpenAI 兼容客户端、Cherry Studio、Open WebUI、Dify 和大部分聊天模型。

请求方法必须是 POST。
返回 HTTP 200 和 choices 字段。
模型名称与控制台展示完全一致。
成功标志：返回模型回复，并在 OmniDino 控制台中出现对应调用记录。
Chat Completions 
curl https://api.omnidino.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {
        "role": "user",
        "content": "Reply with: OmniDino connected"
      }
    ]
  }'

Responses

常用于 Codex、OpenAI Responses 兼容客户端、Agent 和部分推理模型。

路径为 /v1/responses。
请求必须使用 POST，而不是浏览器直接 GET。
渠道和模型端点需要真正支持 Responses。
出现 not implemented 或请求转换失败时，通常说明渠道类型、Wire API 或协议转换器选择不匹配。
Responses 
curl https://api.omnidino.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "input": "Reply with: OmniDino connected"
  }'

Claude Messages

用于 Claude Code、Claude Desktop 和 Anthropic 兼容工具。客户端通常填写根地址，再由工具拼接具体路径。

Claude Code 中通常填写 https://api.omnidino.com。
不要机械地把所有 Claude 配置都加上 /v1。
确认当前渠道支持 Claude Messages 协议。
具体 Claude 兼容路径取决于 OmniDino 当前渠道配置。若你使用 CC Switch，应以 Claude Code 应用模式和当前字段为准。
Claude Messages 
curl https://api.omnidino.com/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CLAUDE_MODEL",
    "max_tokens": 64,
    "messages": [
      {
        "role": "user",
        "content": "Reply with: OmniDino connected"
      }
    ]
  }'

Gemini 路由

OmniDino 中的 Gemini 可能通过 OpenAI 兼容协议，也可能通过 Gemini 原生协议暴露。

OpenAI 兼容 Gemini 走 /v1/chat/completions。
只有真实支持 Gemini 原生协议时，才使用原生路径。
模型名必须与控制台中的实际名称一致。
不确定协议时，优先在 OmniDino 模型广场、渠道说明或客户端配置教程中确认，不要猜测路径。
Gemini · OpenAI Compatible 
curl https://api.omnidino.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_GEMINI_MODEL",
    "messages": [
      {
        "role": "user",
        "content": "Reply with: OmniDino connected"
      }
    ]
  }'

图片生成

用于支持 OpenAI Images 兼容端点的图片模型，例如 OmniDino 模型广场中已配置的图片生成模型。

路径为 /v1/images/generations。
模型必须是真正的图片生成模型。
返回内容可能是 URL 或 base64 数据。
成功标志：返回图片数据，并在控制台中产生对应图片计费记录。
Images 
curl https://api.omnidino.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_IMAGE_MODEL",
    "prompt": "A small coding dinosaur in a clean futuristic office",
    "size": "1024x1024",
    "quality": "high"
  }'
错误诊断

根据状态码快速定位问题。

同一个错误可能有多个原因。先检查本页列出的高概率项，再查看 OmniDino 控制台和客户端日志。

401

Unauthorized

请求没有通过 API Key 鉴权。

  • 重新复制完整 API Key，检查前后空格。
  • 确认 Key 没有被禁用、删除或过期。
  • 不要把 Bearer 前缀重复写入只要求填写 Key 的输入框。
402 / Insufficient Balance

余额或额度不足

账户余额、令牌额度或分组限制不足以完成请求。

  • 检查账户当前余额。
  • 检查该 API Key 的额度限制。
  • 核对模型价格、分组倍率和实际调用成本。
404

Not Found

通常是请求路径、HTTP 方法或协议不匹配。

  • 检查是否把 GET 用在只支持 POST 的接口。
  • 检查 Claude 根地址和 OpenAI /v1 是否混用。
  • 确认 Responses、Messages 或 Images 路径受当前渠道支持。
429

Too Many Requests

请求频率、并发或上游限流达到限制。

  • 降低并发和重试频率。
  • 为自动重试增加指数退避。
  • 检查是否多个客户端共用同一个 Key。
500 / 502 / 503

服务或上游异常

可能来自模型上游、渠道配置、协议转换或反向代理。

  • 换一个模型测试，判断是否为单模型问题。
  • 查看 OmniDino 状态页和 NewAPI 日志。
  • 确认渠道类型与上游协议一致。
model not found

模型不存在或无权限

模型名称、渠道绑定、令牌分组或端点类型存在问题。

  • 复制模型广场中的真实模型名。
  • 确认模型已经加入对应渠道。
  • 确认当前令牌分组可以访问该模型。
not implemented

端点尚未实现

常见于 Responses 请求进入了不兼容的渠道或转换器。

  • 检查 Wire API 是否选择 Responses。
  • 确认渠道类型不是错误的 NewAPI 或其他转换模式。
  • 确认上游本身支持目标端点。
200

连接成功

请求已经被网关接受并返回正常结果。

  • 继续检查客户端是否正确读取返回内容。
  • 查看控制台调用记录和余额变化。
  • 为正式使用设置合理限额和独立 API Key。
排查顺序

不要一开始就重装客户端。

按照下面的顺序逐层排查，能更快区分网络、密钥、余额、模型和协议问题。

01
确认域名可访问 浏览器或终端能够访问 api.omnidino.com，没有 DNS、证书或网络阻断。
02
测试 /v1/models 确认网关和 API Key 基础鉴权正常。
03
检查余额和令牌额度 确认账户余额、API Key 限额和分组倍率没有阻止请求。
04
确认模型名称 使用模型广场中的实际名称，不自行省略后缀或修改拼写。
05
确认端点类型 Chat、Responses、Claude Messages、Gemini 或 Images 必须与模型和渠道匹配。
06
检查客户端协议 核对 Base URL、Wire API、应用类型和配置文件是否正确。
07
查看网关和上游日志 前面都正常时，再检查 NewAPI 日志、渠道测试和上游返回。
✓

什么情况下算连接成功？

下面这些条件同时满足时，说明 OmniDino 的基础连接和目标模型调用已经正常。

/v1/models 返回正常结果。
目标模型请求返回 HTTP 200。
客户端能够收到并展示模型回复。
控制台出现对应调用记录。
余额发生合理变化。
没有 401、404 或协议转换错误。
报障模板

联系支持时，请提供完整上下文。

复制下面模板，填写后发送至 [email protected]。请隐藏完整 API Key。

支持请求模板 
账户邮箱：
操作系统：
客户端名称：
客户端版本：
Base URL：
接口类型：
模型名称：
HTTP 状态码：
完整错误信息：
问题发生时间：
是否能正常访问 /v1/models：
是否有足够余额：
已尝试的排查步骤：

注意：
请勿提交密码、完整 API Key、支付卡信息或其他敏感数据。
常见问题

测试命令和客户端结果不一致？

说明 OmniDino 网关、Key 和基础端点大概率正常。继续检查客户端 Base URL、协议类型、模型名称、环境变量、代理设置和配置是否真正启用。
不一定。浏览器地址栏发送的是 GET，而 Responses 通常要求 POST。请使用 curl、Postman 或客户端发送正确的 POST 请求。
正常。模型是否支持某端点取决于上游、渠道类型、协议转换和模型配置。Chat 可用不代表 Responses 一定可用。
通常不是 Key 本身的问题，而是客户端重复添加 Bearer、使用了错误 Base URL、请求头格式不同，或目标客户端选择了不兼容协议。
检查响应返回的是图片 URL 还是 base64。部分客户端只支持其中一种格式，还需要确认客户端能否解析该字段。
继续阅读

进入具体客户端教程。

上一篇

CC Switch 快速配置

统一管理 Codex、Claude Code、Gemini CLI 和 OmniDino 供应商配置。

 下一篇

Codex Desktop

继续完成 Codex 桌面端的安装、配置和连接测试。