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

Omini API 是一站式 AI API 聚合平台，为开发者和 AI 工具用户提供统一的模型访问入口。平台使用 OpenAI 兼容接口，可接入 Codex、Claude Code、HermesAgent、OpenClaw 及其他支持自定义 API 地址的客户端。

一、快速开始

1. 注册并登录

打开 Omini API 控制台，完成注册和登录。进入控制台后先查看账户余额、可用分组与模型列表。

2. 创建 API 令牌

1. 进入左侧菜单中的“令牌”页面。
2. 点击创建令牌，填写便于识别的名称。
3. 按需设置额度、有效期、模型范围或 IP 白名单。
4. 创建后立即妥善保存以 sk- 开头的令牌。

3. 选择模型与分组

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

二、调用 API

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

cURL 示例

curl https://api.omini.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "控制台中的模型名称",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    "stream": false
  }' 

Python 示例

先安装 SDK：pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://api.omini.cn/v1",
)

response = client.chat.completions.create(
    model="控制台中的模型名称",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
)

print(response.choices[0].message.content)

将示例中的模型名称替换为控制台实际显示的模型标识。若使用流式响应，将 stream 设置为 true 并按所用 SDK 的流式方式读取结果。

三、X 模型计费说明

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

计费项目	基础单价	说明
输入 Token	¥5 / M	每 100 万输入 Token 收费 5 元
输出 Token	¥30 / M	每 100 万输出 Token 收费 30 元
缓存创建	¥0.05 / M	每 100 万缓存创建 Token 收费 0.05 元

计费公式

基础用量费用：

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

实际费用：

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

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

不同倍率下的单价示例

分组倍率	输入价格	输出价格	缓存创建价格
0.5 倍	¥2.50 / M	¥15.00 / M	¥0.025 / M
1.0 倍	¥5.00 / M	¥30.00 / M	¥0.050 / M
1.2 倍	¥6.00 / M	¥36.00 / M	¥0.060 / M

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

完整账单示例

假设一次请求产生：

• 输入 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 控制台为准。

五、常见问题

现象	常见原因	处理方法
401 Unauthorized	令牌错误、失效或未正确携带	检查 Authorization: Bearer sk-...，必要时重建令牌
模型不存在或无权限	模型名称错误、分组不支持该模型	复制控制台中的完整模型标识并检查分组权限
429	余额不足、请求过快或达到 RPM/TPM 限制	检查余额和日志，降低并发后重试
5xx	上游渠道波动或临时拥堵	稍后重试，并采用指数退避，避免无间隔连续请求
扣费与预估不同	输出较长、命中不同分组倍率或产生缓存费用	核对日志中的输入、输出、缓存用量、模型和分组倍率

六、使用建议

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

七、联系支持

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

• QQ：2543966214
• 微信：17520260974