# OminiAPI 使用教程

Omini API 注册、令牌创建、接口调用、模型计费与常见问题指南。

适用于 OpenAI 兼容客户端，以及 Codex、Claude Code、HermesAgent、OpenClaw 等开发工具。

# Omini API 模型站介绍与快速入门

Omini API 是一站式 AI API 聚合平台，为开发者和 AI 工具用户提供统一的模型访问入口。平台使用 OpenAI 兼容接口，可接入 Codex、Claude Code、HermesAgent、OpenClaw 及其他支持自定义 API 地址的客户端。  
本站1人民币等于1美元，所有模型最终价格为模型价格x倍率  
比如官方的gpt-5.6-sol模型价格为输入5$/M 30$/M 缓存创建0.5￥/M  
在本站价格为分组模型价格x倍率即（假如倍率为0.08） ，那么最终的价格为输入0.4￥/M 2.4￥/M 缓存创建0.04￥/M，比deepseek还便宜，在使用记录可以看到每次调用的价格

**控制台：**[https://api.omini.cn](https://api.omini.cn)  
**API 基础地址：**`https://api.omini.cn/v1`  
**计价单位：**`M` 表示 100 万 Token。  
模型广场：  
支持最新gpt-5.6全系列模型

<div class="callout info" id="bkmrk-"></div>## 一、快速开始

### 1. 注册并登录

打开 [Omini API 控制台](https://api.omini.cn)，完成注册和登录。进入控制台后先查看账户余额、渠道状态、可用分组与模型列表。

### 2. 创建 API 令牌

[![image.png](https://docx-api.omini.cn/uploads/images/gallery/2026-07/scaled-1680-/Aitimage.png)](https://docx-api.omini.cn/uploads/images/gallery/2026-07/Aitimage.png)

1. 进入左侧菜单中的“API密钥”页面。
2. 点击创建密钥按钮，填写便于识别的名称。
3. 然后选择相应的分组，不同的分组对应不同的模型渠道
4. 创建后立即妥善保存以 `sk-` 开头的令牌。

**请勿公开 API 令牌。**不要把令牌提交到 Git 仓库、截图、网页前端或群聊中。发现泄露后应立即删除旧令牌并重新创建。

<div class="callout warning" id="bkmrk--2"></div>### 3. 选择模型与分组

模型名称必须与控制台显示的标识完全一致。不同分组可能有不同的可用模型、稳定性、速率限制和计费倍率；调用前请确认令牌有权使用所选分组与模型。

## 二、调用 API

Omini API 采用 OpenAI 兼容格式。现有 OpenAI SDK 或支持自定义 Base URL 的客户端，通常只需替换 API 地址和令牌。

下面是调用API的模板  
模型供应商：omini  
base url为：https://api.omini.cn/v1  
API密钥：sk-xxxxxxxxxxxxxx（您自己创建的令牌）  
模型ID：gpt-5.5

## 三、X 模型计费说明

[![image.png](https://docx-api.omini.cn/uploads/images/gallery/2026-07/scaled-1680-/2Kpimage.png)](https://docx-api.omini.cn/uploads/images/gallery/2026-07/2Kpimage.png)

下表为 官方X 模型的美元基础单价。平台按照实际 Token 用量分别计算输入、输出和缓存创建费用。

<table id="bkmrk-%E8%AE%A1%E8%B4%B9%E9%A1%B9%E7%9B%AE%E5%9F%BA%E7%A1%80%E5%8D%95%E4%BB%B7%E8%AF%B4%E6%98%8E-%E8%BE%93%E5%85%A5-token%C2%A5"><thead><tr><th>计费项目</th><th>基础单价</th><th>说明</th></tr></thead><tbody><tr><td>输入 Token</td><td>**$5 / M**</td><td>每 100 万输入 Token 收费 5 元</td></tr><tr><td>输出 Token</td><td>**$30 / M**</td><td>每 100 万输出 Token 收费 30 元</td></tr><tr><td>缓存创建</td><td>**$0.05 / M**</td><td>每 100 万缓存创建 Token 收费 0.05 元</td></tr></tbody></table>

<span style="color:rgb(224,62,45);">本中转站采用1美元1人民币并且在此基础上乘以分组倍率后的价格最终如下（比如分组倍率价格为0.08）</span>

<table id="bkmrk-%E8%AE%A1%E8%B4%B9%E9%A1%B9%E7%9B%AE-%E5%9F%BA%E7%A1%80%E5%8D%95%E4%BB%B7%EF%BC%88%E4%B9%98%E4%BB%A5%E5%88%86%E7%BB%84%E5%80%8D%E7%8E%87%E5%90%8E%E7%9A%84%E4%BB%B7%E6%A0%BC"><thead><tr><th>计费项目</th><th>基础单价（乘以分组倍率后的价格）</th><th>说明</th></tr></thead><tbody><tr><td>输入 Token</td><td>**¥0.4 / M**</td><td>每 100 万输入 Token 收费 0.4 元</td></tr><tr><td>输出 Token</td><td>**¥2.4 / M**</td><td>每 100 万输出 Token 收费 2.4元</td></tr><tr><td>缓存创建</td><td>**¥0.04 / M**</td><td>每 100 万缓存创建 Token 收费 0.04 元</td></tr></tbody></table>

再对比deepseek的价格

### 计费公式

**基础用量费用：**

```
输入 Token ÷ 1,000,000 × 5
+ 输出 Token ÷ 1,000,000 × 30
+ 缓存创建 Token ÷ 1,000,000 × 0.05
```

**实际费用：**

```
实际费用 = 基础用量费用 × 分组倍率
```

分组倍率会因分组而异，并可能根据上游成本和资源情况调整。最终倍率以控制台调用时显示的分组配置和账单记录为准。

### 不同倍率下的单价示例

<table id="bkmrk-%E5%88%86%E7%BB%84%E5%80%8D%E7%8E%87%E8%BE%93%E5%85%A5%E4%BB%B7%E6%A0%BC%E8%BE%93%E5%87%BA%E4%BB%B7%E6%A0%BC%E7%BC%93%E5%AD%98%E5%88%9B%E5%BB%BA%E4%BB%B7%E6%A0%BC-0" style="width:39.7619%;height:186.375px;"><thead><tr style="height:46.5938px;"><th style="width:21.8563%;height:46.5938px;">分组倍率</th><th style="width:22.7311%;height:46.5938px;">输入价格</th><th style="width:24.9907%;height:46.5938px;">输出价格</th><th style="width:30.2395%;height:46.5938px;">缓存创建价格</th></tr></thead><tbody><tr style="height:46.5938px;"><td style="width:21.8563%;height:46.5938px;">0.5 倍</td><td style="width:22.7311%;height:46.5938px;">¥2.50 / M</td><td style="width:24.9907%;height:46.5938px;">¥15.00 / M</td><td style="width:30.2395%;height:46.5938px;">¥0.025 / M</td></tr><tr style="height:46.5938px;"><td style="width:21.8563%;height:46.5938px;">1.0 倍</td><td style="width:22.7311%;height:46.5938px;">¥5.00 / M</td><td style="width:24.9907%;height:46.5938px;">¥30.00 / M</td><td style="width:30.2395%;height:46.5938px;">¥0.050 / M</td></tr><tr style="height:46.5938px;"><td style="width:21.8563%;height:46.5938px;">1.2 倍</td><td style="width:22.7311%;height:46.5938px;">¥6.00 / M</td><td style="width:24.9907%;height:46.5938px;">¥36.00 / M</td><td style="width:30.2395%;height:46.5938px;">¥0.060 / M</td></tr></tbody></table>

以上倍率仅用于演示计算方法，不代表当前一定存在对应分组。

### 完整账单示例

假设一次请求产生：

- 输入 20 万 Token，即 `0.2 M`
- 输出 5 万 Token，即 `0.05 M`
- 缓存创建 10 万 Token，即 `0.1 M`
- 所选分组倍率为 `0.8`

```
基础费用 = 0.2 × 5 + 0.05 × 30 + 0.1 × 0.05
         = 1 + 1.5 + 0.005
         = ¥2.505

实际费用 = 2.505 × 0.8
         = ¥2.004
```

因此这次请求实际扣费约为 **¥2.004**。控制台可能按系统精度保留更多小数，累计账单以平台记录为准。

## 四、接入常用工具

在支持 OpenAI 兼容接口的应用中，一般填写以下两项即可：

- **Base URL：**`https://api.omini.cn/v1`
- **API Key：**在 Omini API 控制台创建的令牌

Codex、Claude Code、HermesAgent、OpenClaw 等工具的配置字段会随版本变化。若工具提供“自定义服务商”“OpenAI Compatible”或“Base URL”选项，选择对应模式并填入以上信息；模型名称以 Omini API 控制台为准。

**方式一：接入codex**  
1.如果没有codex可在此蓝奏网盘下载按照https://wwasj.lanzn.com/iSkUD3vn3pkb  
2.Codex++配置工具（用来配置API进codex）下载地址：https://github.com/BigPizzaV3/CodexPlusPlus/releases  
3.codex可按此步骤配置codex++，然后保存重启

[![ebfd98953879c9123624a05effe661fd.png](https://docx-api.omini.cn/uploads/images/gallery/2026-07/scaled-1680-/ebfd98953879c9123624a05effe661fd.png)](https://docx-api.omini.cn/uploads/images/gallery/2026-07/ebfd98953879c9123624a05effe661fd.png)

**方法二：接入cc switch**

## 五、常见问题

<table id="bkmrk-%E7%8E%B0%E8%B1%A1%E5%B8%B8%E8%A7%81%E5%8E%9F%E5%9B%A0%E5%A4%84%E7%90%86%E6%96%B9%E6%B3%95-401-unaut"><thead><tr><th>现象</th><th>常见原因</th><th>处理方法</th></tr></thead><tbody><tr><td>`401 Unauthorized`</td><td>令牌错误、失效或未正确携带</td><td>检查 `Authorization: Bearer sk-...`，必要时重建令牌</td></tr><tr><td>模型不存在或无权限</td><td>模型名称错误、分组不支持该模型</td><td>复制控制台中的完整模型标识并检查分组权限</td></tr><tr><td>`429`</td><td>余额不足、请求过快或达到 RPM/TPM 限制</td><td>检查余额和日志，降低并发后重试</td></tr><tr><td>`5xx`</td><td>上游渠道波动或临时拥堵</td><td>稍后重试，并采用指数退避，避免无间隔连续请求</td></tr><tr><td>扣费与预估不同</td><td>输出较长、命中不同分组倍率或产生缓存费用</td><td>核对日志中的输入、输出、缓存用量、模型和分组倍率</td></tr></tbody></table>

## 六、使用建议

- 测试新模型时先设置较小的令牌额度，确认调用和计费符合预期后再提高限额。
- 为不同应用创建独立令牌，便于统计成本和快速撤销权限。
- 生产环境设置合理的超时、重试次数和并发上限。
- 定期检查调用日志与余额，异常消耗时立即停用相关令牌。
- 模型、分组和倍率可能动态调整，重要业务应在调用前查看控制台公告。

## 七、联系支持

遇到充值、模型权限或账单问题时，请准备账号、请求时间、模型名称和请求日志编号后联系平台：

- QQ：`2543966214`
- 微信：`17520260974`

本页价格按人民币直接展示。X 模型当前基础价格为输入 ¥5/M、输出 ¥30/M、缓存创建 ¥0.05/M；实际费用还需乘以所选分组倍率。

## 八、模型检测（是否渗水检测）

模型保真，100%纯血，绝不掺水，可自行测试模型

https://docx-api.omini.cn/

[![image.png](https://docx-api.omini.cn/uploads/images/gallery/2026-07/scaled-1680-/JYkimage.png)](https://docx-api.omini.cn/uploads/images/gallery/2026-07/JYkimage.png)