API Key 配置

Gemini API Key：获取与配置教程

配置 Gemini API Key 时，先确定密钥由谁发放，再对应设置 API 地址与模型 ID。下面的步骤演示如何通过 OmniaKey 接入。

模型厂商官方 Key

需要由 Google 直接发放与计费的密钥时，请按厂商自己的账号与 API Key 文档操作。

查看官方获取方式

OmniaKey API Key

用一个 OmniaKey 账户余额与密钥调用账号可用的模型。该密钥对应 OmniaKey API 地址。

获取 API Key

01创建 OmniaKey API Key

登录后打开 API Key 页面，为应用创建密钥，并检查额度、有效期与模型限制。开始生成内容前，先确保账户有可用余额。

获取 API Key

02设置密钥与 API 地址

在自己的终端执行下面的命令，将占位符替换成你的密钥。密钥只保存在服务端或密钥管理器里，不要写进浏览器代码或公开仓库。

bash / zsh

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03验证密钥连接

先请求模型列表，不启动生成任务。成功时会返回包含 data 数组的 JSON。这一步验证密钥访问权限，不代表账号能调用列表中的所有模型。

GET /v1/models

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04按模型协议发送请求

从系列页选择模型，复制准确的 API 模型 ID，再按对应文档接入。鉴权通过不代表生成参数已经正确。

客户端需要支持所选模型使用的协议。在 Chat Completions、Responses 与厂商原生接口之间切换前，请先检查模型文档。

生成请求示例（会产生费用）

这条请求会使用账户余额，请先查看所选模型的价格。示例按已记录的接口格式编写，账号仍需拥有该模型的调用权限。

POST /v1beta/models/gemini-4-argon:generateContent

curl --fail-with-body 'https://api.omniakey.com/v1beta/models/gemini-4-argon:generateContent' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain what an API key does in one sentence."
        }
      ]
    }
  ]
}'

阅读 API 文档

连接失败时怎么排查

401：检查密钥是否完整、是否有效，以及密钥的发放平台是否与请求地址一致。
403：检查 Key 的模型限制与账户可用权限。
404 或返回 HTML：检查 API 域名与版本前缀，使用 api.omniakey.com，而不是官网地址。
429：降低并发并按响应提示重试，不要不断换幂等键重新提交同一个生成任务。