返回

OMG Router 文档

OMG Router API 中转、客户端接入、模型分组与排障指南

文章目录

OMG Router 文档#

OMG Router 是一个统一的 AI API 中转入口，面向 OpenAI 兼容接口、Claude 官方协议、Gemini 兼容接口，以及 Codex、Claude Code、Cherry Studio、CC Switch 等工具接入场景。

常用地址#

用途地址
控制台https://api.omgrouter.cc ↗
API Base URLhttps://api.omgrouter.cc/v1
OpenAI 兼容模型列表GET https://api.omgrouter.cc/v1/models
价格与模型广场https://api.omgrouter.cc/pricing ↗
CC Switch 页面https://api.omgrouter.cc/ccswitch ↗

文档目录#

页面内容
快速开始注册、充值、创建 API Key、第一次调用
API 调用示例curl、Python、Node、OpenAI SDK、Claude、Gemini、嵌入
模型分组默认、CC、CC-N、Codex 分组选择规则
客户端接入Codex、Claude Code、CC Switch、Cherry Studio、OpenCode
排障指南401、模型不存在、协议不匹配、跳转失败、余额问题
验证记录本次文档示例的实际调试结果

最小可用调用#

export OMG_API_KEY="sk-你的API令牌"

curl https://api.omgrouter.cc/v1/chat/completions \
  -H "Authorization: Bearer $OMG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "只回复 OK" }
    ],
    "max_tokens": 8
  }'
bash

成功时会返回 OpenAI Chat Completions 兼容格式，正文在 choices[0].message.content。

安全提醒#

  • 不要把真实 API Key 写进公开文档、截图、Git 仓库或前端代码。
  • 文档示例统一使用 sk-你的API令牌、$OMG_API_KEY 占位。
  • 如果 API Key 曾经泄露，请在控制台删除旧令牌并重新创建。
Edit on GitHub