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

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# API de turbopuffer

> Ejecuta tu código y SDK de turbopuffer en Conare cambiando la URL base: escrituras, consultas y llamadas de namespace compatibles, y sus límites.

Conare sirve la API de turbopuffer en `https://api.conare.ai/tpuf`: conserva tu código y tu SDK de turbopuffer, y apúntalos a Conare con una clave de Conare.

```bash curl theme={null}
curl https://api.conare.ai/tpuf/v2/namespaces/products/query \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rank_by": ["vector", "ANN", [0.1, 0.2, 0.3, 0.4]], "top_k": 10}'
```

```python Python theme={null}
import os
import turbopuffer

tpuf = turbopuffer.Turbopuffer(
    api_key=os.environ["CONARE_API_KEY"],
    region="gcp-us-central1",  # any value: Conare ignores it
    base_url="https://api.conare.ai/tpuf/{region}",
)

ns = tpuf.namespace("products")
ns.write(
    upsert_rows=[{"id": 1, "vector": [0.1, 0.2, 0.3, 0.4], "title": "refunds"}],
    distance_metric="cosine_distance",
)
result = ns.query(rank_by=("vector", "ANN", [0.1, 0.2, 0.3, 0.4]), top_k=10)
```

```json Response theme={null}
{
  "billing": { "billable_logical_bytes_queried": 0, "billable_logical_bytes_returned": 0 },
  "performance": { "cache_hit_ratio": 1.0, "cache_temperature": "hot", "query_execution_ms": 0, "server_total_ms": 0 },
  "rows": [{ "$dist": 0.0, "id": 1 }]
}
```

Tú aportas tus propios vectores, y estos namespaces están separados de los del resto de la API.

## Compatible

| Área | Compatible |
| - | - |
| Escrituras | Upserts, patches, eliminaciones, escrituras condicionales, eliminación o patch por filtro |
| Consultas | Vectoriales (ANN y exactas), texto completo BM25, ordenación por atributo, filtros, agregación `Count`, hasta 16 consultas en una llamada |
| Namespaces | Listado, esquema, metadatos, calentamiento de caché, eliminación, copia y ramificación |
| Distancia | `cosine_distance`, `euclidean_squared` |
| `top_k` | Hasta 10.000 |

Cualquier otra cosa, como `group_by` o varias columnas vectoriales, devuelve `400` con un mensaje que la nombra.

## Límites

| Límite | |
| - | - |
| Consultas | 1.000 por segundo por organización |
| Escrituras, otras llamadas | 100 por segundo cada una |
| Cuerpo de la solicitud | Hasta 64 MiB |


## Related topics

- [Descripción general de la API](https://docs.conare.ai/es/api.md)
- [SDK de TypeScript](https://docs.conare.ai/es/sdk.md)
- [Tipos de archivo y Markdown](https://docs.conare.ai/es/file-types.md)
- [Consola](https://docs.conare.ai/es/console.md)
- [Introducción](https://docs.conare.ai/es/index.md)


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