Descrição
We have integrated the five core interfaces of Jina AI, helping you easily build powerful intelligent agents. These interfaces are primarily suitable for o seguinte scenarios:- Vector Embeddings (Embeddings):Applicable to multi-modal RAG question-answering scenarios, como smart customer service, smart recruitment, and knowledge base question-answering.
- Reranking (Rerank):By optimizing the Embedding candidate results, sorting them based on topic relevance, significantly improving the quality of the answers from large language models.
- Deep Search (DeepSearch):Perform deep search and reasoning until the optimal answer is found, particularly suitable for complex tasks como research projects and product solution development.
- Web Search (Search):Passe uma consulta e obtenha o corpo de texto limpo da página de resultados do buscador (SERP), pronto para alimentar diretamente um LLM para perguntas e respostas conectadas à web e RAG.
- Web Reader (Reader):Passe qualquer URL e obtenha o corpo Markdown limpo dessa página após a conversão, ideal para extrair conteúdo web e alimentar um LLM.
Início Rápido
Substitua oAPI_KEY with AIHUBMIX_API_KEY and the model endpoint link, and the other parameters and usage are fully consistent with Jina AI official.
Endpoint Replacement:
-
Vector Embeddings (Embeddings):
https://jina.ai/embeddings->https://aihubmix.com/v1/embeddings -
Reranking (Rerank):
https://api.jina.ai/v1/rerank->https://aihubmix.com/v1/rerank -
Deep Search (DeepSearch):
https://deepsearch.jina.ai/v1/chat/completions->https://aihubmix.com/v1/chat/completions -
Web Search (Search):
https://s.jina.ai/?q=->https://aihubmix.com/v1/jina/search?q= -
Web Reader (Reader):
https://r.jina.ai/<url>->https://aihubmix.com/v1/jina/reader/<url>Se o endereço principal atual da API estiver indisponível, substitua o domínio nesta configuração pelo endereço de backuphttps://api.inferera.com; mantenha o caminho inalterado.
Embeddings
Jina AI’s Embedding suporta both plain text and multi-modal images, and performs excellently in handling multi-language tasks.Parâmetros da Requisição
Model name, available model list:
jina-clip-v2:Multi-modal, multilingual, 1024-dimensional, 8K context window, 865M parametersjina-embeddings-v3:Text model, multilingual, 1024-dimensional, 8K context window, 570M parametersjina-colbert-v2:Multi-language ColBERT model, 8K token context, 560M parameters, used for embedding and rerankingjina-embeddings-v2-base-code:Model optimized for code and document search, 768-dimensional, 8K context window, 137M parameters
Input text or image, different models support different input formats. For text, provide an array of strings; for multi-modal models, provide an array of objects containing text or image fields.
Data type returned, optional values:
float:Default, return a float array. The most common and easy-to-use format, return a list of floatsbinary_int8:Return as int8 packed binary format. More efficient storage, search, and transmissionbinary_uint8:Return as uint8 packed binary format. More efficient storage, search, and transmissionbase64:Return as base64 encoded string. More efficient transmission
The number of dimensions used in computation. Supported values:
- 1024
- 768
1. Multimodal Usage
2. Pure Text Usage
Only provide an array of text strings, do not provide theimage field.
Rerank
Reranker aims to improve search relevance and RAG accuracy. It deep analyzes the initial search results, considers the subtle interactions between the query and document content, and reorders the search results to place the most relevant results at the top.Parâmetros da Requisição
Model name, available model list:
jina-reranker-m0:Multimodal multilingual document reranker, 10K context, 2.4B parameters, for visual document sorting
Search query text, used to compare with candidate documents
The number of most relevant documents to return. Default returns all documents
Array of candidate documents, will be reordered based on relevance to the query
Maximum chunk length per document, applicable only to Cohere (not supported by Jina). Defaults to 4096.
Long documents will be automatically truncated to the specified number of tokens.
Long documents will be automatically truncated to the specified number of tokens.
1. Multimodal Usage
Response Description
model: The name of the model usedresults: An array of reranking results sorted by relevance score in descending order, each element contains:index: The index position no original document arrayrelevance_score: A relevance score between 0-1, higher scores indicate greater relevance to the query
usage: Usage statisticstotal_tokens: Total number of tokens processed in this request
2. Text Usage
Text reranking suporta both multilingual and regular tasks, similar to embedding usage, by passing in an array.DeepSearch
DeepSearch combines search, reading, and reasoning capabilities to pursue the best possible answer. It’s fully compatible with OpenAI’s Chat API format—just replace api.openai.com with aihubmix.com to get started.The stream will return the thinking process.
Parâmetros da Requisição
Model name, available models:
jina-deepsearch-v1:Default model, search, read and reason until the best answer is found
Whether to enable streaming response. It is strongly recommended to keep this option enabled, DeepSearch requests may take a long time to complete, disabling streaming may result in a ‘524 Timeout’ error
The list of conversation messages between the user and the assistant. Suporta multiple types (modal) messages, como text (.txt, .pdf), images (.png, .webp, .jpeg), etc. The maximum file size is 10MB
Multimodal Message Format
DeepSearch suporta multiple types of message formats, which can include pure text (message), files (file), and images (image). O seguinte are examples of different formats:1. Pure Text Message
2. Message with File Attachment
3. Message with Image
Example of Calling
Observe que Jina AI’s Python streaming call on the official website will not have a response; consulte our example.Response Description
The response from DeepSearch is streamed by default, including both intermediate reasoning steps and the final answer. The last block of the stream contains the final response, a list of visited URLs, and token usage details. If streaming is disabled, only the final answer will be returned—intermediate “thinking” steps will be omitted. Note: This JSON object differs a partir do format used by Jina AI.Python
Web Search (Search)
Baseado nos.jina.ai da Jina AI: passe uma consulta e obtenha o corpo de texto limpo da página de resultados do buscador (SERP), pronto para alimentar diretamente um LLM para perguntas e respostas conectadas à web e RAG. O endpoint suporta tanto GET quanto POST.
Formato de resposta (Markdown por padrão): por padrão, retorna uma lista de resultados em Markdown concatenada, pronta para alimentar um LLM; quando você precisar de dados estruturados (
title / url / content e usage de cada resultado), adicione o cabeçalho de requisição Accept: application/json para obter JSON.Parâmetros da Requisição
Texto da consulta. Deve ser codificado em URL ao chamar a partir de código.
Número máximo de resultados a retornar; a quantidade real depende de quantos resultados estão disponíveis.
Código de país / região, p. ex.
US.Idioma da interface, p. ex.
en.Restringe a busca a sites específicos; pode ser passado várias vezes, p. ex.
site=jina.ai&site=github.com.Formato do corpo dos resultados, um de
markdown / html / text.Política de retenção de imagens; passe
none para remover imagens e economizar tokens.Ignora o cache e obtém os resultados mais recentes.
X-* que controlam a formatação do corpo listados em «Web Reader (Reader)» também se aplicam aos resultados da busca.
Example of Calling
A consulta e os parâmetros podem ser passados como parâmetros de consulta da URL viaGET (recomendado, o mais conciso), ou em um corpo de requisição JSON via POST; ambos atingem o mesmo endpoint e retornam o mesmo resultado. Os exemplos abaixo adicionam Accept: application/json para retornar JSON por padrão; remova esse cabeçalho para obter uma lista de resultados em Markdown limpa (veja o primeiro exemplo Curl-markdown).
Response Description
Por padrão (semAccept), retorna uma lista Markdown concatenada, onde cada entrada indica sucessivamente o título, o link de origem, a descrição (se houver) e o corpo:
Accept: application/json, retorna JSON estruturado:
data: array de resultados da busca (a quantidade é controlada pornum; o exemplo acima retorna 5, mas apenas os 2 primeiros são mostrados aqui;contenté o corpo completo, truncado no exemplo), cada um contendotitle,url,content,usage.tokens.- Cobrança: cobrado pela soma dos
usage.tokensde cada resultado; a Jina cobra oficialmente um mínimo de 10000 tokens por busca, então o valor final é o maior dos dois, ou seja,max(10000, soma dos tokens).
Web Reader (Reader)
Baseado nor.jina.ai da Jina AI: passe qualquer URL e obtenha o corpo Markdown limpo dessa página após a conversão, conveniente para extrair conteúdo web e alimentar um LLM. Além de páginas web, também suporta a análise de imagens (descritas por um modelo de visão) e arquivos locais (PDF, Word / Excel / PPT, HTML, imagens).
Formato de resposta (Markdown por padrão): por padrão, retorna diretamente o corpo Markdown limpo, pronto para alimentar um LLM; quando você precisar de JSON estruturado com
usage e campos como title / url (o corpo fica em data.content), adicione o cabeçalho de requisição Accept: application/json.Parâmetros da Requisição
O endereço web a ler, anexado diretamente ao final do caminho do endpoint, p. ex.
/v1/jina/reader/https://jina.ai.O arquivo local a enviar; suporta PDF, Word / Excel / PPT, HTML, imagens, passado no campo
file via POST como multipart/form-data.Obrigatório ao enviar um arquivo HTML, usado como endereço de referência para resolver os links relativos da página; não é necessário ao enviar um PDF.
Formato de retorno, um de
markdown / html / text / screenshot / pageshot.Política de retenção de imagens, uma de
all / none (remover imagens para economizar tokens) / alt.Política de retenção de links, uma de
all / none / text.Gera automaticamente texto descritivo para imagens sem
alt.Resume todos os links no final do corpo.
Resume todas as imagens no final do corpo.
Motor de extração, um de
browser / direct / cf-browser-rendering.Seletor CSS; extrai apenas a região correspondente da página.
Seletor CSS; remove os elementos correspondentes (p. ex.
header, footer, nav).Tempo limite de extração em segundos, máx. 180.
Ignora o cache e obtém o mais recente.
Estilo de títulos Markdown, um de
atx (#) / setext (sublinhado).Marcador de lista com marcadores Markdown, um de
- / + / *.Estilo da linha horizontal Markdown, p. ex.
***.Estilo de links Markdown, um de
inlined / referenced / discarded.X-* suportados pela Jina (incluindo toda a família X-Md-*) bem como os campos do corpo POST (como o script injetado injectPageScript) são encaminhados como estão pelo gateway; para a lista completa e os valores, consulte a documentação oficial da Jina.
Multimodal Input Format
Reader suporta três tipos de entrada. Páginas web e imagens são anexadas diretamente ao final do caminho do endpoint (GET); arquivos locais são enviados via POST como multipart/form-data.
1. URL de página web
2. URL de imagem (retorna uma descrição visual)
O endereço da imagem também é anexado ao final do caminho. Reader usa um modelo de visão para gerar uma descrição (uma legenda, não um OCR literal) da imagem e a coloca emcontent.
3. Enviar um arquivo local (PDF / Word·Excel·PPT / HTML / imagem)
Example of Calling
Por padrão, retorna diretamente o corpo Markdown; adicioneAccept: application/json para obter JSON estruturado. Os parâmetros opcionais são passados como cabeçalhos de requisição X-* e são todos encaminhados como estão pelo gateway para a Jina (para a lista completa, veja «Parâmetros da Requisição» acima).
1. Ler uma página web
2. Ler uma imagem
Curl
3. Enviar um arquivo local
Envie viaPOST + multipart/form-data; ao enviar HTML, você também deve incluir o campo url como endereço de referência. A cobrança é a mesma que a leitura de uma URL.
Response Description
Por padrão (semAccept), retorna diretamente o corpo Markdown (ou seja, o conteúdo de data.content no JSON abaixo). Por exemplo, ao ler https://example.com:
Accept: application/json, retorna JSON estruturado. A estrutura do JSON é a mesma para os três tipos de entrada: data é um único objeto contendo title / url / content / usage.tokens. Abaixo estão as respostas reais para os três tipos de entrada (quando content é muito longo, o início é mantido e o restante é omitido com …).
① Ler uma página web (lendo https://example.com):
content é a descrição gerada pelo modelo de visão):
content é longo, apenas o início é mostrado):
status: o código de status de negócio retornado pela Jina upstream; em uma chamada de reader bem-sucedida é20000(consistente com o HTTP200externo).- Cobrança: cobrado por
data.usage.tokens(o número real de tokens de saída), sem cobrança mínima (diferente do «mínimo de 10000 tokens por busca» da busca); para conteúdo extremamente curto, uma unidade mínima de cobrança é aplicada como piso, de modo que uma cobrança de zero nunca ocorre.
Última atualização: 2026-07-03