接口总览
地址、鉴权方式、支持的接口与限制
OminiApi 兼容 OpenAI、Anthropic、Gemini 三家的官方接口格式，直接使用官方 SDK，只需要改地址和 Key。
基础地址
https://omini.ominiapi.top| SDK / 工具 | 地址怎么填 |
|---|---|
| OpenAI SDK | https://omini.ominiapi.top/v1 |
| Anthropic SDK | https://omini.ominiapi.top（不带 /v1） |
| Google Gen AI SDK | https://omini.ominiapi.top（不带 /v1beta） |
鉴权
所有接口都支持以下三种请求头，任选一种：
Authorization: Bearer sk-xxxxxxxx
x-api-key: sk-xxxxxxxx
x-goog-api-key: sk-xxxxxxxx- 不支持把 Key 放在 URL 参数（
?key=）里。 - 同时带多个请求头且值不一致时，请求会被拒绝（401）。
Bearer注意大小写。
支持的接口
| 方法 | 路径 | 格式 | 文档 |
|---|---|---|---|
| POST | /v1/chat/completions | OpenAI | Chat Completions |
| POST | /v1/responses | OpenAI Responses | Responses |
| GET（WebSocket） | /v1/responses | OpenAI Responses | Responses |
| POST | /v1/responses/compact | OpenAI Responses | Responses |
| POST | /v1/messages | Anthropic | Messages |
| POST | /v1/messages/count_tokens | Anthropic | Messages |
| POST | /v1beta/models/{model}:generateContent | Gemini | Gemini |
| POST | /v1beta/models/{model}:streamGenerateContent | Gemini | Gemini |
| GET | /v1/models | OpenAI | 模型列表 |
| POST | /v1/images/generations | OpenAI Images | 绘图模型 |
| POST | /v1/images/edits | OpenAI Images | 绘图模型 |
暂不支持
Embeddings（/v1/embeddings）、音频（/v1/audio/*）、旧版 Completions（/v1/completions）、Moderations 等接口目前不支持，会返回 404。
跨格式调用
平台会在不同接口格式之间自动转换，例如用 OpenAI 格式调用 Claude 模型、用 Anthropic 格式调用 GPT 模型。某个模型能否通过某个接口调用，取决于你的密钥所在分组的线路配置。
- 调不通时会返回 400
No eligible upstream supports the requested interface or model，换用该模型的原生接口通常就能解决。 - 某些参数在目标格式里没有对应含义时，会返回 400
unsupported request semantics: ...。
要获得最完整的功能（例如各家特有的缓存、思考参数），建议用模型的原生接口调用：Claude 用 Messages，GPT 用 Responses，Gemini 用 Gemini 接口。
请求限制
| 项目 | 限制 |
|---|---|
| 请求体大小 | 最大 16 MiB |
| 请求体上传 | 30 秒内需要发送完毕 |
| 流式首字节 | 默认 60 秒内没有输出会自动切换线路重试 |
| 流式中途空闲 | 默认 30 秒没有新数据视为中断 |
| 非流式总时长 | 默认 300 秒 |
长时间生成的任务建议使用流式（stream: true），体验更好也更不容易超时。
响应头
每次响应都会带上 X-Request-ID，与 使用日志 里的请求 ID 一致，排查问题时请提供它。
上游的限流头（如 Retry-After、x-ratelimit-*）不会透传给客户端。