> ## 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 - Access Google Gemini Models via AIsa

> AIsa guide to Google Gemini model IDs and endpoints through the Gemini-compatible generateContent API.

AIsa gives you access to Google's Gemini models with one AIsa API key. Gemini models use the Gemini-compatible `POST /v1beta/models/{model}:generateContent` endpoint, so the Google Gen AI SDK works after you change its base URL.

## Supported Gemini models

| Model ID | Type | Endpoints |
| - | - | - |
| `gemini-3.8-flash` | Text | `/v1beta/models/{model}:generateContent` |
| `gemini-4-argon` | Text | `/v1beta/models/{model}:generateContent` |

Current prices for these models are on [aisa.one/models](https://aisa.one/models).

## Quickstart

AIsa reads the key from `Authorization: Bearer` or `x-api-key`, not from Google's `x-goog-api-key` header, so pass it as an extra header.

```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)
```

Request and response fields are in [Gemini Generate Content](https://aisa.one/docs/api-reference/chat/post_models-model-generatecontent.md).

## Next

* [OpenAI / Anthropic SDK](https://aisa.one/docs/get-started/sdk-compatibility.md)
* [Model Catalog](https://aisa.one/docs/guides/models.md)
* [AI model pricing](https://aisa.one/docs/guides/pricing.md#models)


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