Jina Search Foundation API
Best-in-class embeddings, rerankers and document models for multilingual and multimodal search. Capabilities Text embeddings — dense vectors for semantic…
AI & machine learning#machine-learning
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Best-in-class embeddings, rerankers and document models for multilingual and multimodal search.
Capabilities
- Text embeddings — dense vectors for semantic search, similarity, clustering and classification, in 100+ languages.
- Multimodal embeddings — images, video, audio and PDFs embedded into the same space as text, so a query in one modality retrieves another.
- Reranking — score a query against a candidate set and reorder it; more accurate than embedding similarity, and the usual second stage after it.
- Document OCR — read a page image and return its content as text or markdown, with tables and layout preserved, over the OpenAI chat completions schema.
- Batch embeddings — the same embedding models over JSONL, asynchronously, for workloads too large to send inline.
Authentication
Every endpoint except GET /v1/models requires a key:
Authorization: Bearer jina_YOUR_API_KEYGet one at jina.ai/api-dashboard/key-manager.
Rate limits
Requests per minute and tokens per minute. Anything over a limit answers 429.
| Endpoint | Free | Paid | Premium |
|---|---|---|---|
/v1/embeddings | 500 RPM · 1M TPM | 500 RPM · 10M TPM | 5,000 RPM · 100M TPM |
/v1/rerank | 500 RPM · 1M TPM | 500 RPM · 10M TPM | 5,000 RPM · 100M TPM |
/v1/chat/completions | 100 RPM · 500K TPM | 100 RPM · 5M TPM | 1,000 RPM · 50M TPM |
Errors
Failures carry a detail, a code from the table below and the request_id to quote in a support request. /v1/chat/completions is the exception: it answers in OpenAI's error envelope, with the same code inside it.
| Code | Status | Meaning |
|---|---|---|
INPUT_INVALID_LABELS | 400 | Invalid training labels |
INPUT_LABEL_LIMIT_EXCEEDED | 400 | Label limit exceeded: labels provided, maximum allowed for your plan |
INPUT_MODEL_NOT_FOUND | 400 | Model ' ' not found |
INPUT_TOKEN_LIMIT_EXCEEDED | 400 | Input text exceeds the model's maximum of tokens |
AUTH_INVALID_API_KEY | 401 | Invalid API key |
AUTH_INVALID_FORMAT | 401 | Invalid authorization format |
AUTH_MISSING_API_KEY | 401 | Authentication required |
AUTHZ_INSUFFICIENT_BALANCE | 403 | Insufficient account balance |
AUTHZ_RESOURCE_LIMIT_EXCEEDED | 403 | Resource limit exceeded for your plan |
RESOURCE_NOT_FOUND | 404 | ' ' not found or access denied |
CONFLICT_RESOURCE_BUSY | 409 | ' ' is currently being modified |
RATE_CONCURRENCY_LIMIT_EXCEEDED | 429 | Concurrency limit exceeded: / concurrent requests |
RATE_IP_LIMIT_EXCEEDED | 429 | IP rate limit exceeded |
RATE_REQUEST_LIMIT_EXCEEDED | 429 | Request rate limit exceeded: / requests per minute |
RATE_TOKEN_LIMIT_EXCEEDED | 429 | Token rate limit exceeded: / tokens per minute |
INTERNAL_ERROR | 500 | An unexpected error occurred |
SERVICE_UNAVAILABLE | 503 | Service temporarily unavailable |
SERVICE_TIMEOUT | 504 | Service request timed out |
Endpoints 11
Model List
- GETList Models
/v1/modelsEvery model in the catalogue, with its modalities, limits and price. - GETGet Model
/v1/models/:model_idOne model by id, in full (jina-ai/jina-embeddings-v3) or short (jina-embeddings-v3) form.
Search Foundation Models
- POSTEmbeddings
/v1/embeddingsEmbed text, images, audio, video or PDFs as dense vectors. model selects the request shape as well as the model: each one below lists the inputs and options… - POSTRerank
/v1/rerankScore documents against a query and return them reordered. Results come back sorted by relevance_score, each carrying the index it held in the request so the…
Generative Models
- POSTChat Completions
/v1/chat/completionsTranscribe a document image. Send the page as an image_url content part and the reply is its text; response_format with a json_schema constrains that to a…
Batch Embeddings
- POSTCreate a batch embedding job
/v1/batch/embeddingsSubmit a batch of texts for asynchronous embedding processing. - GETGet batch job status
/v1/batch/:batch_idRetrieve the status of a batch embedding job. - DELETECancel a batch job
/v1/batch/:batch_idCancel a pending or processing batch job. - GETList batch jobs
/v1/batchesList recent batch jobs for the authenticated user. - GETDownload batch job output
/v1/batch/:batch_id/outputStream the output JSONL file for a completed batch job. - GETDownload batch job error file
/v1/batch/:batch_id/errorsStream the error JSONL file for a completed batch job.
API details
- Base URL
https://api.jina.ai- Authentication
- A bearer token in the Authorization header
- Operations
- 11 operations on 10 pathsGET 6POST 4DELETE 1
- Main resources
- Batch Embeddings 6Model List 2Search Foundation Models 2Generative Models 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
2026.10.13.1624 - Links
- OpenAPI document
- Listed from
- Jina's published OpenAPI description
How to test the Jina Search Foundation API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Jina Search Foundation API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List Models” (GET /v1/models), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Jina Search Foundation API?
Best-in-class embeddings, rerankers and document models for multilingual and multimodal search. Capabilities Text embeddings — dense vectors for semantic… It is listed under AI & machine learning and has 11 endpoints.
Who publishes the Jina Search Foundation API?
It is listed from Jina's public API description (an OpenAPI document), not published by Jina on Swastik Codes. Anyone who controls jina.ai can claim the profile by adding a DNS TXT record.
What is the base URL of the Jina Search Foundation API?
Requests go to https://api.jina.ai. Endpoint paths are added to this base URL.
How do I authenticate with the Jina Search Foundation API?
With A bearer token in the Authorization header.
How many endpoints does the Jina Search Foundation API have?
11 operations on 10 paths (6 GET, 4 POST, 1 DELETE). The largest groups are Batch Embeddings, Model List, Search Foundation Models, Generative Models.
Is forking the Jina Search Foundation API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.