> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# Gemini API - 通过 AIsa 访问 Google Gemini 模型

> Google Gemini 模型 ID 和端点指南：通过 Gemini 兼容的 generateContent API 调用。

AIsa 用一个 API Key 接入 Google 的 Gemini 模型。Gemini 模型使用 Gemini 兼容的 `POST /v1beta/models/{model}:generateContent` 端点，所以 Google Gen AI SDK 只需改 base URL 即可使用。

## 支持的 Gemini 模型

| 模型 ID | 类型 | 端点 |
| - | - | - |
| `gemini-3.8-flash` | 文本 | `/v1beta/models/{model}:generateContent` |
| `gemini-4-argon` | 文本 | `/v1beta/models/{model}:generateContent` |

这些模型的当前价格见 [aisa.one/models](https://aisa.one/models)。

## 快速开始

AIsa 从 `Authorization: Bearer` 或 `x-api-key` 读取 Key，不读 Google 的 `x-goog-api-key` 请求头，所以要把 Key 作为额外请求头传入。

```python theme={null}
from google import genai
from google.genai import types
import os

key = os.environ["AISA_API_KEY"]
client = genai.Client(
    api_key=key,
    http_options=types.HttpOptions(base_url="https://api.aisa.one", headers={"x-api-key": key}),
)

response = client.models.generate_content(model="gemini-3.8-flash", contents="Explain vector databases in three sentences.")
print(response.text)
```

请求和响应字段见 [Gemini Generate Content](https://aisa.one/docs/zh/api-reference/chat/post_models-model-generatecontent.md)。

## 下一步

* [OpenAI / Anthropic SDK](https://aisa.one/docs/zh/get-started/sdk-compatibility.md)
* [模型目录](https://aisa.one/docs/zh/guides/models.md)
* [AI 模型价格](https://aisa.one/docs/zh/guides/pricing.md#模型)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.