> ## 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

# Jina API - Access Jina Embedding and Rerank Models via AIsa

> AIsa guide to Jina embedding and reranker model IDs and endpoints for retrieval and search.

AIsa gives you access to Jina's embedding and reranker models with one AIsa API key. Embedding models use the OpenAI-compatible `POST /v1/embeddings` endpoint, and the reranker uses `POST /v1/rerank`. A common retrieval setup embeds and shortlists candidates first, then reranks them for the final order.

## Supported Jina models

| Model ID | Type | Endpoints |
| - | - | - |
| `jina-embeddings-v3` | Embedding | `/v1/embeddings`, `/v1/classify` |
| `jina-embeddings-v5-text-small` | Embedding | `/v1/embeddings` |
| `jina-reranker-v3` | Rerank | `/v1/rerank` |

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

## Quickstart

Embed text with the OpenAI SDK:

```python theme={null}
from openai import OpenAI

client = OpenAI(api_key="YOUR_AISA_API_KEY", base_url="https://api.aisa.one/v1")

response = client.embeddings.create(
    model="jina-embeddings-v5-text-small",
    input=["A fast, OpenAI-compatible embeddings endpoint."],
)
print(len(response.data[0].embedding))
```

Rerank documents against a query:

```bash theme={null}
curl https://api.aisa.one/v1/rerank \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jina-reranker-v3",
    "query": "What is the capital of France?",
    "documents": ["Paris is the capital of France.", "Berlin is the capital of Germany."]
  }'
```

Request and response fields are in [Embeddings](https://aisa.one/docs/api-reference/embeddings/post_embeddings-create.md) and [Rerank Documents](https://aisa.one/docs/api-reference/rerank/post_rerank-create.md).

## Next

* [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.