跳转到主要内容

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

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

????控制台：https://api.omini.cn
API ?????基础地址：https://api.omini.cn/v1
?????计价单位：M ??表示 100 ?万 Token?Token。

??????一、快速开始

1. ?????注册并登录

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

2. ??创建 API ??令牌

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

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

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?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??Token，即 0.2 M
  • ??输出 5 ?万 Token??Token，即 0.05 M
  • ????缓存创建 10 ?万 Token??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?URL：https://api.omini.cn/v1
  • API Key?Key：?在 Omini API ????????控制台创建的令牌

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

??????五、常见问题

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

??????六、使用建议

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

??????七、联系支持

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

  • QQ?QQ：2543966214
  • ???微信：17520260974

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

回到顶部