> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniakey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 概览

> OmniaKey 的 base URL、认证方式、三套协议、端点矩阵和公开能力边界。

OmniaKey 在同一个 API 主机上提供三套协议：

```text theme={null}
https://api.omniakey.com
```

同一把 OmniaKey API key 可以调用当前公开目录里的 Claude、GPT、Gemini 模型。

## Base URL

| 协议           | Base URL                          | 常见用途                                |
| ------------ | --------------------------------- | ----------------------------------- |
| OpenAI 兼容    | `https://api.omniakey.com/v1`     | OpenAI SDK、Cursor、Codex、Cline、aider |
| Anthropic 原生 | `https://api.omniakey.com`        | Claude Code、Anthropic SDK           |
| Gemini 原生    | `https://api.omniakey.com/v1beta` | Google Gen AI SDK                   |

<Note>
  Anthropic SDK 会自动拼接 `/v1/messages`，所以 Claude Code 和 Anthropic SDK
  使用裸域名。
</Note>

## 端点矩阵

| 端点                                       | 推荐模型              | 返回协议                    | 适合场景                        |
| ---------------------------------------- | ----------------- | ----------------------- | --------------------------- |
| `/v1/chat/completions`                   | Claude、GPT、Gemini | OpenAI Chat Completions | 大多数工具和 SDK                  |
| `/v1/responses`                          | GPT               | OpenAI Responses        | Codex 类 GPT workflow        |
| `/v1/messages`                           | Claude            | Anthropic Messages      | Claude Code 和 Anthropic SDK |
| `/v1beta/models/{model}:generateContent` | Gemini            | Gemini Generate Content | Gemini 原生 SDK               |
| `/v1/models`                             | Claude、GPT、Gemini | OpenAI 兼容模型列表           | 模型发现                        |
| `/v1beta/models`                         | Gemini            | Gemini 模型列表             | Gemini 原生模型发现               |

## 公开能力边界

当前公开 docs 只覆盖文本和 coding-agent 工作流：

* OpenAI 兼容 Chat Completions 和 Responses
* Anthropic Messages
* Gemini Generate Content
* 模型列表、认证、流式输出、额度和用量可视化

图片、音频、embeddings、rerank、files、fine-tuning、batches 暂不作为公开能力承诺。

## 模型策略

OmniaKey 不会静默替换、量化或蒸馏模型。你请求的 model id 就是实际路由的模型。