返回

快速开始

5 分钟接入 OMG Router API

文章目录

快速开始#

本页从账号、额度、API Key 到第一次接口调用，带你完成最小可用接入。

1. 注册并登录#

访问控制台：

https://api.omgrouter.cc ↗

完成邮箱注册后登录控制台。建议使用强密码，并妥善保存登录凭证。

2. 充值额度#

登录后进入「钱包管理」或「充值」页面，根据控制台当前支持的支付方式充值。额度到账后即可用于 API 调用。

实际扣费会受模型价格、分组倍率、输入输出 token 数、图片/视频任务价格等因素影响。价格和可用模型以控制台「模型广场」/「价格」页面为准：

https://api.omgrouter.cc/pricing ↗

3. 创建 API Key#

进入「令牌管理」页面创建令牌。

建议填写：

字段建议
令牌名称按用途命名，例如 local-test、production、codex
令牌分组根据工具选择，见 模型分组
过期时间生产环境建议设置合理过期时间
额度限制给测试环境设置额度上限，避免误用
模型限制只开放当前业务需要的模型

复制令牌后请立即保存。文档和代码中统一用环境变量承载：

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

Windows PowerShell：

$env:OMG_API_KEY = "sk-你的API令牌"
powershell

4. 查询可用模型#

curl https://api.omgrouter.cc/v1/models \
  -H "Authorization: Bearer $OMG_API_KEY"
bash

返回示例：

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4-mini",
      "object": "model"
    }
  ]
}
json

如果模型列表为空或缺少目标模型，通常是令牌分组不匹配，或该模型未对当前账号/分组开放。

5. 第一次聊天调用#

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

响应中的文本位置：

choices[0].message.content
text

6. 选择正确协议#

场景推荐端点Base URL
GPT / OpenAI 兼容聊天POST /v1/chat/completions 或 POST /v1/responseshttps://api.omgrouter.cc/v1
Claude 官方协议POST /v1/messageshttps://api.omgrouter.cc
Gemini 兼容接口POST /v1beta/models/{model}:generateContenthttps://api.omgrouter.cc
Codex CLIResponses APIhttps://api.omgrouter.cc/v1
Cherry Studio OpenAI 兼容OpenAI Compatible / New APIhttps://api.omgrouter.cc

注意：是否在 Base URL 里带 /v1 取决于客户端。OpenAI SDK 通常填写 https://api.omgrouter.cc/v1；Claude、Gemini、部分第三方客户端会自己拼接路径，通常填写 https://api.omgrouter.cc。

Edit on GitHub