# Gemini 接口

https://modelportal.ai/docs/gemini-api?lang=zh

Gemini 兼容接口沿用 Google Gemini API 的 REST 路径和请求体，可以用 Google GenAI SDK 或直接发 HTTP 请求调用目录里的模型。

## 接入

- REST 地址前缀是 `https://modelportal.ai/v1beta`；Google GenAI SDK 的 base_url 填 `https://modelportal.ai`，SDK 会自己拼 `/v1beta`。
- 密钥放在 `x-goog-api-key` 请求头、查询参数 `key` 或 `Authorization: Bearer` 中任意一处；带了几处时必须相同。
- 模型 ID 写在路径里，斜杠可以直接写，也可以写成 `%2F`。

```bash
curl "https://modelportal.ai/v1beta/models/MODEL_ID:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"role": "user", "parts": [{"text": "你好"}]}]}'
```

```python
from google import genai
from google.genai import types

client = genai.Client(
    api_key="YOUR_API_KEY",
    http_options=types.HttpOptions(base_url="https://modelportal.ai"),
)
reply = client.models.generate_content(model="MODEL_ID", contents="你好")
print(reply.text)
```

## 与 OpenAI 格式不同的地方

- 流式用 `:streamGenerateContent?alt=sse`；不带 `alt=sse` 时返回 JSON 数组。
- `generation_config`、`system_instruction` 以及其中的 `max_output_tokens`、`candidate_count` 会换成驼峰写法；同一字段两种写法同时出现时拒绝。
- 不填 `maxOutputTokens` 时，平台按模型的输出上限和你的可用余额补一个值。
- 路由偏好用请求头 `X-ModelPortal-Provider-Preferences` 传，见[供应商选择](/docs/provider-routing)。
- 错误体是 `{"error": {"code", "message", "status"}}`，`status` 只由 HTTP 状态决定。

接口与字段见 [Gemini 兼容接口参考](/docs/api-gemini)。