Skip to content
Omini API 使用指南

开发者 API 接入指南 ​

Omini API 的控制台地址为 https://api.omini.cn。以下使用 OpenAI 兼容请求格式,接入前先确认密钥分组支持相应接口。

一、准备环境变量 ​

在本地或服务器环境中设置 OMINI_API_KEY 与 OMINI_MODEL。密钥取自控制台,模型取自当前分组的模型列表。

sh
export OMINI_API_KEY='YOUR_API_KEY'
export OMINI_MODEL='YOUR_MODEL_ID'

Windows PowerShell 使用:

powershell
$env:OMINI_API_KEY = 'YOUR_API_KEY'
$env:OMINI_MODEL = 'YOUR_MODEL_ID'

示例中的值需要替换。实际应用应把密钥放在服务端环境中,由自己的后端发起请求。

二、Python:发送 Responses 请求 ​

安装 SDK:

sh
python -m pip install openai

保存为 hello.py:

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['OMINI_API_KEY'],
    base_url='https://api.omini.cn/v1',
)
response = client.responses.create(
    model=os.environ['OMINI_MODEL'],
    input='只回复连接成功',
)
print(response.output_text)

运行 python hello.py。这会发起实际模型请求,请先确认账户和分组额度。

三、Chat Completions 客户端 ​

若你的渠道开放 Chat Completions,可以使用同一个客户端对象:

python
response = client.chat.completions.create(
    model=os.environ['OMINI_MODEL'],
    messages=[{'role': 'user', 'content': '只回复连接成功'}],
)
print(response.choices[0].message.content)

两种请求的路径和消息结构不同。接入某个客户端前,先确认它支持的协议以及当前分组开放的协议。

四、常用配置检查 ​

检查项正确方向
Base URL以 /v1 结尾,避免重复拼接
认证Authorization: Bearer API_KEY
模型使用分组开放的准确 ID
超时为长输出设置适当的读取超时
重试对临时错误有限重试,对密钥和参数错误先修正配置

更多客户端连接问题见 常见报错。请求格式参考 OpenAI Responses 文档 和 Python SDK。

Omini API · 安装、接入与使用指南