# 常用应用

https://omnimodel.me/docs/apps?lang=zh

支持 OpenAI 兼容接口的应用基本都能直接接入。[应用接入中心](/apps)整理了常用客户端、编程助手、工作流工具、浏览器插件和官方 SDK 的逐步配置，登录后还能一键填入你的密钥。

## 通用的三项配置

几乎所有应用都只需要填这三项：

| 配置项 | 填写内容 |
| --- | --- |
| API 地址（Base URL） | `https://omnimodel.me/v1` |
| API 密钥 | 控制台「密钥」页创建的 `key_` 开头的密钥 |
| 模型 | [模型目录](/catalog)里的模型 ID |

应用里的「供应商类型」请选 **OpenAI 兼容**（有的应用叫 OpenAI API Compatible 或自定义 OpenAI）。只支持 Anthropic 或 Gemini 协议的工具，分别把地址填成 `https://omnimodel.me/anthropic` 或 `https://omnimodel.me/v1beta`。

## 按应用类型选择

| 类型 | 典型用途 | 建议 |
| --- | --- | --- |
| 客户端 | 日常对话、多模型切换 | 给客户端单独建一把密钥，限制可用模型 |
| 编程助手 | 代码生成、重构、解释 | 选上下文较长的模型，设置每日消费上限 |
| 工作流 | 批量处理、自动化节点 | 设置每月上限，关注[用量](/docs/usage)里的失败率 |
| 浏览器插件 | 网页翻译、划词解释 | 调用频繁，优先选价格较低的模型 |
| SDK | 在自己的服务端代码里调用 | 密钥放在服务端环境变量，不要打包进前端 |

## 接入后连不通时

1. 检查 API 地址是否以 `/v1` 结尾，不要多写 `/chat/completions`。
2. 检查密钥是否复制完整、没有被暂停或撤销（错误码 `auth.invalid_key`）。
3. 检查模型 ID 是否填错，或者不在这把密钥的可用模型里（`model.unavailable`、`auth.forbidden`）。
4. 应用拉取模型列表为空时，确认密钥的可用模型设置：`GET /v1/models` 只返回该密钥能调用的模型。

## 常见问题

### 应用里的 API 地址要不要带 /chat/completions？

不要。填 https://omnimodel.me/v1 即可，应用会自己拼接具体接口路径。

### 应用里看不到模型列表怎么办？

GET /v1/models 只返回当前密钥可以调用的模型。检查密钥的可用模型设置，或直接手动填写模型 ID。

### 可以在网页或插件里直接用密钥吗？

个人使用的客户端和插件可以，但不要把密钥写进公开发布的前端代码。建议给每个应用单独建密钥并设置消费上限。