注册成功只代表账户可登录。请继续检查账户余额、API Key 是否启用、Key 的分组、模型权限和可用渠道。建议先访问模型列表，再用低成本模型发送最小请求。

常见原因包括：API Key 自身设置了额度上限、Key 已耗尽、用户分组倍率提高了实际扣费、预扣额度不足，或所选模型没有配置价格。请同时检查账户余额、Key 额度、模型价格和分组倍率。

不可以。公开前端中的 Key 会被任何访问者读取并滥用。生产网站应由后端保存 OmniDino Key，再由前端调用你的后端接口。浏览器工作台仅适合让用户自行填写自己的独立 Key。

立即在 OmniDino 控制台停用或删除该 Key，创建新 Key，并检查调用日志、余额和异常模型。不要只修改客户端配置而保留旧 Key。

检查 Authorization 请求头是否为 Bearer YOUR_KEY，Bearer 后需要一个空格。还要检查复制时是否包含换行、引号或前后空格，以及请求是否发到了正确的 OmniDino 域名。

建议。为 Codex、Claude Code、Cherry Studio、Dify 和图片工作台分别创建 Key，可以独立设置额度、停用权限并定位异常消耗。

OpenAI 兼容客户端通常填写 https://api.omnidino.com/v1。Anthropic 原生 Provider 通常填写根地址 https://api.omnidino.com，由客户端自行拼接 Messages 路径。具体以对应教程为准。

多数客户端需要 Base URL，而不是完整端点。客户端会自动拼接 /chat/completions、/responses 或 /models。若你填写完整路径，可能出现重复路径，例如 /chat/completions/chat/completions。

Chat Completions 以 messages 为核心，兼容范围最广。Responses 更适合新式工具调用、结构化多模态输入和 Agent 工作流。客户端使用哪个端点，取决于它的 Provider 实现和模型能力。

不能直接互换。两者请求结构、工具 Schema、系统提示词和流式事件不同。NewAPI 可以做协议适配，但渠道类型、模型映射和客户端 Provider 必须匹配。

Gemini 原生协议使用 Google 的 generateContent 风格路径与数据结构；OpenAI 兼容协议使用 /v1/chat/completions。部分模型在两种协议下的工具调用、多模态字段和错误信息可能不同。

/models 只验证认证和模型列表读取。聊天还会检查模型名称、渠道、分组、价格、上游能力、上下文和请求参数，因此需要继续查看聊天请求的具体错误。

NewAPI 没有找到同时满足模型、用户分组、渠道分组和启用状态的渠道。检查用户分组、渠道分组、渠道支持模型、模型映射、渠道状态，以及渠道是否配置了可用 Key。

为模型配置倍率或固定价格，或者在仅供自己使用的环境中启用自用模式。没有价格信息时，NewAPI 无法完成额度预扣和计费。

程序预期收到 JSON，却收到了 HTML 页面。常见原因是上游被 Cloudflare 拦截、返回登录页、WAF 验证页、Nginx 错误页，或 Base URL 填错。用 curl 查看原始响应头和响应体。

优先级决定先使用哪一组渠道，数值更高的优先尝试。相同优先级下，权重决定流量分配比例。故障切换还受自动禁用、重试和渠道状态影响。

渠道测试通常使用管理员指定模型和简单请求；用户调用还受用户分组、模型价格、Key 限制、模型映射、请求参数和端点类型影响。必须查看用户调用日志。

模型广场展示与用户实际权限不是同一层。检查 Key 的模型限制、用户分组、渠道分组、模型价格和渠道是否支持该模型。

模型映射把客户端提交的模型 ID 转换为上游真实模型名。映射错误可能导致渠道测试正常但实际调用失败，尤其是在端点推断、Responses 和图片模型场景中。

上游连续返回认证、余额、限流或服务错误时，系统可能根据自动禁用策略暂停渠道。查看渠道日志和错误次数，修复后再手动启用。

至少备份 PostgreSQL 或 MySQL 数据库、docker-compose.yml、环境变量、NewAPI 数据目录、Redis 配置、Nginx Proxy Manager 配置和自定义主题文件。升级前记录当前镜像标签，方便回滚。

数据库迁移、环境变量、旧缓存、渠道类型或新版本端点行为可能变化。先检查容器日志、数据库迁移结果、Redis 连接和反代路径，再测试最小 /models 请求。

先缩减为最小请求，只保留 model、messages 和 stream:false。然后逐项加入 tools、response_format、多模态内容、图片参数或其他高级字段，找出上游不支持的参数。

可能是用户或 Key 无模型权限、上游区域限制、WAF 拦截、敏感内容策略、IP 黑名单或组织权限不足。查看响应正文，不要只看状态码。

通常是 Base URL 或端点错误、重复 /v1、模型路由不存在，或者客户端使用了网关不支持的端点。确认实际请求 URL。

增加客户端超时时间，降低 max_tokens，先关闭工具和长上下文，检查上游延迟与反代超时。Nginx、Cloudflare、客户端和 NewAPI 都可能各自设置超时。

请求 JSON 能解析，但字段不符合上游 Schema。例如 tools 参数格式错误、必填数组缺失、枚举值无效或图片字段类型不正确。

查看响应正文和 NewAPI 日志。429 可能表示账户余额不足、Key 额度不足、RPM/TPM 限制、上游并发限制或渠道负载饱和。

500 多为应用内部错误；502 表示网关收到无效上游响应；503 表示服务暂不可用；504 表示上游超时。需要结合 NewAPI、Nginx 和上游日志判断。

不一定。浏览器中的 Failed to fetch 常由 CORS、HTTPS 证书、Cloudflare、浏览器扩展、本地代理或网络中断引起。使用 curl 从服务器端交叉测试。

减少历史消息、缩短系统提示词、降低检索片段数量、清理工具输出，或切换支持更长上下文的模型。注意上下文限制通常包含输入和计划输出。

请求可能命中了 WordPress 页面、Nginx 默认站点、登录页、Cloudflare 验证页或上游错误页面。使用 curl -i 查看状态码、Content-Type 和 Location。

OpenAI 兼容配置通常使用 https://api.omnidino.com/v1，并在配置中选择兼容的 wire API。Responses 模型需要渠道与客户端都支持 Responses。

当前渠道类型、上游或 NewAPI 版本没有实现 /responses，或者该模型只支持 Chat Completions。切换渠道类型、端点模式或使用支持 Responses 的模型。

技术上可以通过兼容网关和模型映射实现，但工具调用、Responses 事件、推理参数和结构化输出不一定完全兼容。应逐模型测试，不要只验证普通聊天。

文件修改和 Agent 任务依赖工具调用、长上下文、结构化事件和权限。确认模型支持 Tools，并检查工作目录权限、沙箱设置和客户端日志。

Codex 通常不会自动展示所有网关模型。请在配置文件中显式填写模型 ID，并确认该模型可通过配置的端点调用。

确认 Node.js 和 npm 已安装，重新打开终端，检查 npm 全局 bin 是否进入 PATH。也可以在 WSL 中安装并运行。

使用 Anthropic 兼容网关时通常设置 ANTHROPIC_BASE_URL 为 https://api.omnidino.com，并通过对应凭证变量或网关配置提供 Key。不要使用 OpenAI 的 /v1 Chat 地址。

Claude Code 中 API Key 可能优先于订阅凭证。若希望回到订阅登录，清除相关环境变量并重新登录，再用 /status 检查当前认证方式。

可能是 OAuth 凭证过期、系统时间不准确、macOS Keychain 问题或凭证保存失败。重新登录并运行诊断命令检查环境。

这是客户端安全机制。检查项目权限、工具白名单和 settings 配置。不要为了省事对未知项目开放无限制执行权限。

检查 MCP 配置文件位置、JSON 格式、启动命令、环境变量和服务器日志。重启 Claude Code 后用工具状态命令确认服务器是否连接。

不是。Claude 订阅和 Anthropic API 计费通常是独立体系。通过 OmniDino 网关调用时，以 OmniDino Key 和余额为准。

需要客户端支持自定义 Base URL 或兼容 Provider。若 Gemini CLI 版本只支持 Google 官方认证，则不能直接替换为 OpenAI 兼容网关。可通过 CC Switch 或支持自定义 Provider 的工具配置。

API Key 用于 Gemini API；OAuth 用于 Google 账号登录流程。第三方网关凭证不能简单替代 Google OAuth。

可能是 Google 项目配额、API 未启用、区域限制、Key 权限或上游额度不足。通过 OmniDino 调用时，还要检查渠道余额和用户分组。

OpenAI 工具 Schema 与 Gemini 原生 Schema 的枚举和字段约束可能不同。移除复杂工具参数后测试，或切换为原生 Gemini 协议。

确认所选模型支持视觉输入，客户端发送的是兼容的多模态格式，并且 NewAPI 与上游正确透传图片 URL 或 Base64 数据。

确认 Provider 类型和 Base URL。OpenAI Provider 通常填写 https://api.omnidino.com/v1；Anthropic Provider 通常填写根地址。若自动获取失败，可手动添加真实模型 ID。

先关闭流式验证普通请求。若普通请求成功，检查上游 SSE、Nginx 缓冲、Cloudflare、客户端版本和模型是否支持流式。

检查模型 Provider 插件、凭证验证、模型类型和模型 ID。Dify 的 LLM、Embedding 和 Rerank 是不同类型，不能混用。

通常是没有配置 Text Embedding 模型、Embedding 请求失败、维度不一致或文档解析失败。先单独测试 Embeddings 端点。

所选模型可能不支持 Function Calling，或工具 Schema 不兼容。先用单个简单工具测试，并降低最大迭代次数。

模型列表和聊天请求是不同接口。检查 Open WebUI 的 Base URL、API Key、模型 ID、流式设置和 NewAPI 调用日志。

说明认证和基本聊天链路正常，问题集中在 SSE 流式传输、代理缓冲、客户端解析或上游流式事件格式。

生成图片使用 /v1/images/generations，编辑图片使用 /v1/images/edits。不要把图片模型当作普通聊天模型调用。

图片模型常返回 Base64 编码。客户端需要解码为二进制并保存为 PNG、JPEG 或 WebP。

不同图片模型支持的尺寸不同。先使用模型文档中的标准尺寸，并移除自动缩放、比例或质量等额外参数。

确认 background=transparent，并使用支持 Alpha 通道的 PNG 或 WebP。最终能力还取决于模型、上游和网关字段透传。

编辑接口通常需要 multipart/form-data，并把 image[] 和 mask 作为真实文件上传，不能放在 JSON 字符串中。

不同 Whisper 或转写上游支持的 response_format 不同。先移除该字段，使用默认 JSON，再逐项测试 text、srt、vtt 等格式。

Input 是发送给模型的内容；Output 是模型生成的内容；Cache Token 是被上游缓存命中的输入。不同模型对三类 Token 的单价可能不同。

客户端可能使用本地估算器，而实际扣费依据上游返回或网关计费规则。工具调用、图片、缓存、推理 Token 和协议转换也会造成差异。

分组倍率是在模型基础价格上乘以的用户组系数。它可用于区分开发者、标准、商业或不同质量路由，但应清晰说明，避免用户误解。

可能对应不同上游、稳定性、速度、并发、质量或售后等级。模型名相同不代表底层渠道和服务质量完全相同。

定期同步或人工核对上游价格，设置成本预警，保留利润空间，并监控高消耗模型。不要完全依赖一次性的价格同步。

Tokens/s 是生成速度指标，不决定 Token 计费数量。是否亏损取决于上游实际计费、NewAPI 记录的 Token、模型价格和倍率设置。

运行 docker logs 查看数据库、Redis、环境变量、端口和权限错误。常见原因是数据库连接失败、密码不一致、卷权限或迁移异常。

通常不应该。让它们仅加入 Docker 内部网络，不映射公网端口；确需远程维护时使用防火墙、VPN 或 SSH 隧道。

目标填写容器名或服务器内网地址与端口；启用 WebSocket；为长请求设置合理超时；流式输出时避免代理缓冲；配置有效 HTTPS 证书。

表示会话 Cookie 未强制仅通过 HTTPS 发送。站点已完整启用 HTTPS 后，可设置 SESSION_COOKIE_SECURE=true，并确认反代正确传递协议头。

DNS 或反代 Host 配置错误，导致 api 子域进入了前端服务器。检查 Cloudflare DNS、NPM Proxy Host 和目标端口。

代理缓冲会聚合 SSE 数据。关闭对应位置的 proxy_buffering，并确认客户端、Cloudflare 和上游都支持持续连接。

数据库、Redis 持久化、NewAPI 数据目录和 NPM 数据都应使用明确的 volume 或宿主机目录。升级容器不能依赖容器内部临时文件。

用 curl 直接请求 OmniDino；再在 NewAPI 中测试渠道；最后直接请求上游。三层逐级对比状态码、响应体和耗时，可以快速定位。