> ## Documentation Index
> Fetch the complete documentation index at: https://docs.requesty.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# List Embedding Models
> Get all available embedding models. If authenticated with a Requesty API key, returns only the models approved for your organization. Otherwise, returns all public models. Aliases and routing policies are chat-only and are never returned here.
```bash cURL theme={"dark"}
curl https://router.requesty.ai/v1/models/embedding \
-H "Authorization: Bearer YOUR_REQUESTY_API_KEY"
```
```python Python theme={"dark"}
import httpx
response = httpx.get(
"https://router.requesty.ai/v1/models/embedding",
headers={"Authorization": "Bearer YOUR_REQUESTY_API_KEY"},
)
for model in response.json()["data"]:
print(model["id"])
```
```typescript TypeScript theme={"dark"}
const response = await fetch("https://router.requesty.ai/v1/models/embedding", {
headers: { Authorization: `Bearer ${process.env.REQUESTY_API_KEY}` },
});
const { data } = await response.json();
for (const model of data) {
console.log(model.id);
}
```
```json Response 200 theme={"dark"}
{
"object": "list",
"data": [
{
"api": "embedding",
"id": "vertex/google/gemini-embedding-2-preview",
"object": "model",
"created": 1774621394,
"updated": 1774621394,
"owned_by": "system",
"pricing": {
"input_text": 2e-07,
"input_audio": 6.4e-06,
"input_image": 4.651162791e-07,
"input_video": 1.19696969697e-05,
"input_document": 4.651162791e-07
},
"data_retention": false,
"data_retention_days": 0,
"data_used_for_training": true,
"privacy_comments": "N/A",
"geolocation": "global"
}
]
}
```
List the embedding models available through the [`/v1/embeddings`](/api-reference/endpoint/embeddings-create) endpoint.
When authenticated with an API key, returns only the models approved for your organization. Without authentication, returns all publicly available models. Aliases and routing policies exist for chat only, so they never appear here.
## OpenAPI
````yaml GET /v1/models/embedding
openapi: 3.0.3
info:
title: Requesty Inference API
description: >-
Requesty Inference API for AI model routing. OpenAI-compatible endpoints for
chat completions, embeddings, images, audio, and more.
version: 1.0.0
servers:
- url: https://router.requesty.ai
description: Inference router endpoint
security:
- BearerAuth: []
paths:
/v1/models/embedding:
servers:
- url: https://router.requesty.ai
description: Inference router endpoint
get:
summary: List available embedding models
description: >-
Get all available embedding models. If authenticated with a Requesty API
key, returns only the models approved for your organization. Otherwise,
returns all public models. Aliases and routing policies are chat-only
and are never returned here.
operationId: listEmbeddingModels
responses:
'200':
description: List of available models
content:
application/json:
schema:
$ref: '#/components/schemas/EmbeddingModelsResponse'
example:
object: list
data:
- api: embedding
id: vertex/google/gemini-embedding-2-preview
object: model
created: 1774621394
updated: 1774621394
owned_by: system
pricing:
input_text: 2.e-7
input_audio: 0.0000064
input_image: 4.651162791e-7
input_video: 0.0000119696969697
input_document: 4.651162791e-7
data_retention: true
data_retention_days: 0
data_used_for_training: true
privacy_comments: ''
geolocation: global
'400':
description: Bad request - malformed payload or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized - missing or empty Authorization header.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'402':
description: Payment required - organization balance exhausted.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden - invalid token or model not in access list.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found - provider/model not supported.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Rate limit exceeded. Retry after the Retry-After header value.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'502':
description: Bad gateway - upstream provider returned an invalid response.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
- {}
components:
schemas:
EmbeddingModelsResponse:
type: object
required:
- object
- data
properties:
object:
type: string
enum:
- list
description: The object type, always 'list'
data:
type: array
items:
$ref: '#/components/schemas/EmbeddingModel'
description: The list of available embedding models
ErrorResponse:
type: object
required:
- error
properties:
error:
type: object
required:
- origin
- message
properties:
origin:
type: string
enum:
- router
- provider
description: >-
Whether the error originated from Requesty's router or an
upstream provider.
message:
type: string
description: Human-readable error description.
EmbeddingModel:
type: object
properties:
api:
type: string
enum:
- embedding
description: The modality of the model, always 'embedding'
id:
type: string
description: The model identifier (e.g., 'openai/text-embedding-3-small')
object:
type: string
enum:
- model
description: The object type, always 'model'
created:
type: integer
description: The Unix timestamp (in seconds) when the model was created
updated:
type: integer
description: The Unix timestamp (in seconds) when the model was last updated
owned_by:
type: string
description: The system or organization that owns the model
example: system
pricing:
type: object
description: >-
Prices for the model. Only the fields relevant to the model's
pricing scheme are returned.
properties:
input_text:
type: number
format: float
description: Price per input text token in USD
input_audio:
type: number
format: float
description: Price per input audio token in USD
input_image:
type: number
format: float
description: Price per input image token in USD
input_video:
type: number
format: float
description: Price per input video token in USD
input_document:
type: number
format: float
description: Price per input document token in USD
data_retention:
type: boolean
description: Whether the provider retains request data
data_retention_days:
type: integer
description: Number of days the provider retains request data
data_used_for_training:
type: boolean
description: Whether the provider may use request data for training
privacy_comments:
type: string
description: Additional privacy notes for the model
geolocation:
type: string
description: Region the model is served from, e.g. 'us' or 'eu'
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: API key for authentication
````