---
title: "List Models"
method: GET
path: "/v1/models"
tags: ["Model List"]
---

# List Models

`GET /v1/models`

List all available Jina AI models.

Returns model metadata in OpenRouter-compatible format including
model IDs, input/output modalities, context lengths, and pricing.

## Response `200`

Successful Response

- ModelListResponse — Response containing list of available models.
  - `data` ModelInfo[], required — List of available models.
    - `id` string, required — Unique model identifier (e.g., `jina-ai/jina-embeddings-v3`).
    - `hugging_face_id` string, required — HuggingFace model ID.
    - `name` string, required — Human-readable model name.
    - `created` integer, required — Unix timestamp when the model was released.
    - `input_modalities` string[], required — Supported input modalities: `text`, `image`, `video`, `audio`.
    - `output_modalities` string[], required — Output types: `embeddings`, `text`.
    - `quantization` string, required — Quantization level, if any.
    - `context_length` integer, required — Maximum context length in tokens.
    - `max_output_length` integer, required — Maximum output dimensions.
    - `pricing` ModelPricing, required — Pricing information for a model.
      - `prompt` string, required — Price per prompt token.
      - `completion` string, required — Price per completion token.
      - `image` string, required — Price per image.
      - `request` string, required — Price per request.
      - `input_cache_read` string, required — Price for input cache read.
      - `input_cache_write` string, required — Price for input cache write.
    - `supported_sampling_parameters` string[], required — Supported sampling parameters.
    - `supported_features` string[], required — Supported features.
    - `description` string, required — Model description.
    - `datacenters` ModelDatacenter[], required — Available datacenter locations.
      - `country_code` string, required — ISO country code of the datacenter.

## Other responses

- `400` — - **INPUT_MODEL_NOT_FOUND**: Model 'model_name' not found. Available models: .... - **INPUT_INVALID_LABELS**: Invalid training labels. At least {min_labels} unique labels are required for training. - **INPUT_LABEL_LIMIT_EXCEEDED**: Label limit exceeded: {current} labels provided, maximum N allowed for your plan. Reduce the number of labels or upgrade your plan at https://jina.ai/api-dashboard/key-manager. - **INPUT_TOKEN_LIMIT_EXCEEDED**: Input text exceeds the model's maximum of {max_tokens} tokens. Use 'truncate: true' to automatically truncate, or split into smaller chunks.
- `401` — - **AUTH_MISSING_API_KEY**: Authentication required. Provide your API key via the Authorization header: 'Authorization: Bearer <api-key>'. Get your API key at https://jina.ai/api-dashboard/key-manager. - **AUTH_INVALID_API_KEY**: Invalid API key. Verify your API key at https://jina.ai/api-dashboard/key-manager or generate a new one. - **AUTH_INVALID_FORMAT**: Invalid authorization format. Use 'Authorization: Bearer <api-key>' with a valid Jina API key (65 characters, starts with 'jina_').
- `403` — - **AUTHZ_INSUFFICIENT_BALANCE**: Insufficient account balance. Top up your account at https://jina.ai/api-dashboard/key-manager. - **AUTHZ_RESOURCE_LIMIT_EXCEEDED**: Resource limit exceeded for your plan. Current: {current}, limit: N. Delete existing resources or upgrade your plan at https://jina.ai/api-dashboard/key-manager.
- `404` — - **RESOURCE_NOT_FOUND**: {resource_type} '{resource_id}' not found or access denied. Verify the ID and your permissions.
- `409` — - **CONFLICT_RESOURCE_BUSY**: {resource_type} '{resource_id}' is currently being modified. Please retry after a few moments.
- `429` — - **RATE_REQUEST_LIMIT_EXCEEDED**: Request rate limit exceeded: {current}/N requests per minute. Reduce request frequency or upgrade your plan at https://jina.ai/api-dashboard/key-manager. - **RATE_TOKEN_LIMIT_EXCEEDED**: Token rate limit exceeded: {current:,}/{limit:,} tokens per minute. Reduce batch sizes or upgrade your plan at https://jina.ai/api-dashboard/key-manager. - **RATE_CONCURRENCY_LIMIT_EXCEEDED**: Concurrency limit exceeded: {current}/N concurrent requests. Wait for pending requests to complete before sending new ones. - **RATE_IP_LIMIT_EXCEEDED**: IP rate limit exceeded. Too many requests from this IP address. Reduce request frequency.
- `500` — - **INTERNAL_ERROR**: An unexpected error occurred. If this persists, contact support with the request_id from this response.
- `503` — - **SERVICE_UNAVAILABLE**: Service temporarily unavailable. Please retry with exponential backoff.
- `504` — - **SERVICE_TIMEOUT**: Service request timed out. Try with smaller inputs or retry later.

---

[API](https://skmtc.net/jina/apis/jina-search-foundation-api.md) · [All operations](https://skmtc.net/jina/apis/jina-search-foundation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jina/jina-search-foundation-api/versions/0ae64d1cd6e1/schema)