Gemini 原生格式

针对基于 Google GenAI SDK 开发的应用,OmniAPI 提供 Gemini 原生协议兼容:

POST https://api.hlzai.com.cn/v1beta/models/{model}:generateContent
POST https://api.hlzai.com.cn/v1beta/models/{model}:streamGenerateContent

请求示例

curl "https://api.hlzai.com.cn/v1beta/models/omni-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $OMNIAPI_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "用三句话介绍黑洞"}]
    }]
  }'

要点:

• 认证使用 x-goog-api-key 头(也兼容 ?key= 查询参数);
• 多模态输入通过 parts 数组传入 inline_data(base64 图片)等;
• 流式使用 :streamGenerateContent,返回增量 JSON 块;
• 生成参数放在 generationConfig 中(temperature、maxOutputTokens 等)。

该用原生还是 OpenAI 兼容?

情况	建议
新项目 / 多模型切换	用 OpenAI 兼容接口,换模型只改 model
存量 Google SDK 代码	用原生协议,改个 base_url 即可
需要 Gemini 特有字段(如 safety 设置)	用原生协议