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

# turbopuffer API

> 기본 URL만 바꿔 turbopuffer 코드와 SDK를 Conare에서 실행합니다. 지원되는 쓰기, 쿼리 호출과 제한을 설명합니다.

Conare는 `https://api.conare.ai/tpuf`에서 turbopuffer의 API를 제공합니다. turbopuffer 코드와 SDK를 그대로 두고, Conare 키로 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 }]
}
```

벡터는 직접 제공해야 하며, 이 네임스페이스들은 나머지 API의 네임스페이스와 분리되어 있습니다.

## 지원 기능

| 영역 | 지원 |
| - | - |
| 쓰기 | 업서트, 패치, 삭제, 조건부 쓰기, 필터 기반 삭제 또는 패치 |
| 쿼리 | 벡터(ANN 및 정확 검색), BM25 전문 검색, 속성 기준 정렬, 필터, `Count` 집계, 한 번의 호출에 최대 16개 쿼리 |
| 네임스페이스 | 목록, 스키마, 메타데이터, 캐시 워밍, 삭제, 복사, 브랜치 |
| 거리 | `cosine_distance`, `euclidean_squared` |
| `top_k` | 최대 10,000 |

`group_by`나 여러 벡터 열 같은 그 밖의 기능은 해당 기능을 명시한 메시지와 함께 `400`을 반환합니다.

## 제한

| 제한 | |
| - | - |
| 쿼리 | 조직당 초당 1,000회 |
| 쓰기, 기타 호출 | 각각 초당 100회 |
| 요청 본문 | 최대 64 MiB |


## Related topics

- [API 개요](https://docs.conare.ai/ko/api.md)
- [Embed texts (OpenAI-compatible)](https://docs.conare.ai/ko/api-reference/models/embed-texts-openai-compatible.md)
- [Rerank documents (Cohere- and vLLM-compatible)](https://docs.conare.ai/ko/api-reference/models/rerank-documents-cohere-and-vllm-compatible.md)
- [Rerank documents (Cohere v2-compatible)](https://docs.conare.ai/ko/api-reference/models/rerank-documents-cohere-v2-compatible.md)
- [Connect a source](https://docs.conare.ai/ko/api-reference/sources/connect-a-source.md)


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