# 快速开始

https://omnimodel.me/docs/quick-start?lang=zh

从注册到第一次调用只需要四步：注册并验证邮箱、创建 API 密钥、在模型目录选好模型、用兼容接口发请求。

## 1. 注册并验证邮箱

注册后会自动登录。创建 API 密钥、充值和兑换码都要求先验证邮箱，验证链接 24 小时内有效、只能用一次。实例开启了试用额度时，验证邮箱后会发放一笔赠送额度。

## 2. 创建 API 密钥

进入控制台「密钥」页，填写名称即可创建。完整密钥以 `key_` 开头，创建后立即显示一次，请马上保存。之后如需再次查看，需要输入登录密码，详见[密钥管理](/docs/api-keys)。

## 3. 选择模型

在[模型目录](/catalog)找到要用的模型，详情页里的「模型 ID」就是请求里 `model` 字段要填的值。详情页同时列出能力、输入限制和按实例币种标注的价格。

## 4. 发出第一次调用

平台提供三种兼容接口，地址都在本站域名下：

| 协议 | 基础地址 | 认证方式 |
| --- | --- | --- |
| OpenAI 兼容 | `https://omnimodel.me/v1` | `Authorization: Bearer <密钥>` |
| Anthropic 兼容 | `https://omnimodel.me/anthropic` | `x-api-key: <密钥>` 或 Bearer |
| Gemini 兼容 | `https://omnimodel.me/v1beta` | 只接受 `Authorization: Bearer <密钥>` |

用 curl 调用对话接口：

```bash
curl https://omnimodel.me/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "<模型 ID>", "messages": [{"role": "user", "content": "你好"}]}'
```

用 OpenAI Python SDK：

```python
from openai import OpenAI

client = OpenAI(base_url="https://omnimodel.me/v1", api_key="<密钥>")
reply = client.chat.completions.create(
    model="<模型 ID>",
    messages=[{"role": "user", "content": "你好"}],
)
print(reply.choices[0].message.content)
```

## 需要注意的默认行为

- 流式输出：请求里加 `"stream": true`，OpenAI 格式以 `data: [DONE]` 结束。
- 没有填 `max_tokens`（或 `max_completion_tokens`）时按 4096 处理；Anthropic 格式的 `max_tokens` 必填。
- 密钥只能放在请求头里，放进 URL 参数会被拒绝。
- `GET /v1/models` 只列出当前密钥可以调用的模型。
- 余额不足时返回 `billing.insufficient_credit`（HTTP 402），充值后即可继续调用。更多错误见[常见错误](/docs/errors)。

## 常见问题

### 请求里的 model 应该填什么？

填模型目录详情页上的「模型 ID」。GET /v1/models 也会列出当前密钥可以调用的全部模型 ID。

### 必须先验证邮箱吗？

创建 API 密钥、充值和使用兑换码都需要先验证邮箱。浏览模型目录和价格不需要。

### 支持哪些 SDK？

OpenAI 官方 SDK 把 base_url 设为 https://omnimodel.me/v1 即可；Anthropic SDK 设为 https://omnimodel.me/anthropic；Gemini 兼容接口只接受 Authorization: Bearer 头，SDK 需要能改用 Bearer 认证。

### 没填 max_tokens 会怎样？

OpenAI 与 Gemini 格式按 4096 处理；Anthropic 格式的 max_tokens 是必填项，缺少会直接报错。