切换主题
开发者 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。
