---
title: "Create query or document embeddings"
method: POST
path: "/v1/embeddings"
tags: ["v1", "Embeddings"]
---

# Create query or document embeddings

`POST /v1/embeddings`

## Request

- Base URL: `https://memory.papr.ai`
- URL: `https://memory.papr.ai/v1/embeddings`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Request body

- EmbeddingRequest
  - `model` string
  - `input` union, required
    - string
    - string[]
  - `input_type` 'query' | 'document', required
  - `reasoning` ReasoningOptions: Live-teacher band generation. Provider-neutral by design.
    - `tier` 'swift' | 'balanced' | 'frontier'
    - `effort` 'low' | 'medium' | 'high' | 'max'
  - `scoring` 'concat' | 'chamfer'
  - `band_schema_id` string, nullable
  - `schema_id` string, nullable
  - `instruction` string, nullable

## Response `200`

Successful Response

- EmbeddingResponse
  - `object` 'list'
  - `model` string, required
  - `data` EmbeddingData[], required
    - `object` 'embedding'
    - `index` integer, required
    - `embedding` number[], required
  - `usage` EmbeddingUsage, required
    - `input_count` integer, required
    - `total_tokens` integer
    - `reasoning_units` integer
    - `truncated_inputs` integer
    - `max_input_tokens` integer
  - `meta` object, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-29** `6fc381dc78b3`: 1 info
  - the `model` request property default value changed from `papr-embed-v1-0.6b-scifact` to `papr-embed-schema-1-0.6b-scifact`
- **2026-10-16** `0e7a5c0d125d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/papr-ai/apis/papr-memory-api/changes/v1/embeddings/post.md)

---

[API](https://skmtc.dev/papr-ai/apis/papr-memory-api.md) - [All operations](https://skmtc.dev/papr-ai/apis/papr-memory-api/llms.txt) - [OpenAPI document](https://skmtc.dev/papr-ai/apis/papr-memory-api/revisions/6fc381dc78b3?raw)