快速开始
从注册到第一次调用只需要四步:注册并验证邮箱、创建 API 密钥、在模型目录选好模型、用兼容接口发请求。
1. 注册并验证邮箱
注册后会自动登录。创建 API 密钥、充值和兑换码都要求先验证邮箱,验证链接 24 小时内有效、只能用一次。实例开启了试用额度时,验证邮箱后会发放一笔赠送额度。
2. 创建 API 密钥
进入控制台「密钥」页,填写名称即可创建。完整密钥以 key_ 开头,创建后立即显示一次,请马上保存。之后如需再次查看,需要输入登录密码,详见密钥管理。
3. 选择模型
在模型目录找到要用的模型,详情页里的「模型 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 调用对话接口:
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:
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),充值后即可继续调用。更多错误见常见错误。
常见问题
- 请求里的 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 是必填项,缺少会直接报错。