快速开始

最后更新

从注册到第一次调用只需要四步:注册并验证邮箱、创建 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 是必填项,缺少会直接报错。