Saltar para o conteúdo principal

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.
We’ve enhanced the Jina AI API to support future extensions, so the usage may differ slightly a partir do official native implementation.

Início Rápido

Substitua o API_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 backup https://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
string
obrigatório
Model name, available model list:
  • jina-clip-v2:Multi-modal, multilingual, 1024-dimensional, 8K context window, 865M parameters
  • jina-embeddings-v3:Text model, multilingual, 1024-dimensional, 8K context window, 570M parameters
  • jina-colbert-v2:Multi-language ColBERT model, 8K token context, 560M parameters, used for embedding and reranking
  • jina-embeddings-v2-base-code:Model optimized for code and document search, 768-dimensional, 8K context window, 137M parameters
input
array
obrigatório
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.
embedding_format
string
padrão:"float"
Data type returned, optional values:
  • float:Default, return a float array. The most common and easy-to-use format, return a list of floats
  • binary_int8:Return as int8 packed binary format. More efficient storage, search, and transmission
  • binary_uint8:Return as uint8 packed binary format. More efficient storage, search, and transmission
  • base64:Return as base64 encoded string. More efficient transmission
dimensions
integer
padrão:"1024"
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 the image 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
string
obrigatório
Model name, available model list:
  • jina-reranker-m0:Multimodal multilingual document reranker, 10K context, 2.4B parameters, for visual document sorting
query
string
obrigatório
Search query text, used to compare with candidate documents
top_n
integer
The number of most relevant documents to return. Default returns all documents
documents
array
obrigatório
Array of candidate documents, will be reordered based on relevance to the query
max_chunk_per_doc
integer
padrão:"4096"
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.

1. Multimodal Usage

Response Description

Response successful:
  • model: The name of the model used
  • results: An array of reranking results sorted by relevance score in descending order, each element contains:
    • index: The index position no original document array
    • relevance_score: A relevance score between 0-1, higher scores indicate greater relevance to the query
  • usage: Usage statistics
    • total_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
string
obrigatório
Model name, available models:
  • jina-deepsearch-v1:Default model, search, read and reason until the best answer is found
stream
boolean
padrão:"true"
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
messages
array
obrigatório
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

All files and images must be encoded in data URI format (data URI) in advance, with a maximum file size of 10MB.

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 Return Example:
Python
Baseado no s.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

q
string
obrigatório
Texto da consulta. Deve ser codificado em URL ao chamar a partir de código.
num
integer
padrão:"5"
Número máximo de resultados a retornar; a quantidade real depende de quantos resultados estão disponíveis.
gl
string
Código de país / região, p. ex. US.
hl
string
Idioma da interface, p. ex. en.
site
string
Restringe a busca a sites específicos; pode ser passado várias vezes, p. ex. site=jina.ai&site=github.com.
X-Respond-With
string
padrão:"markdown"
Formato do corpo dos resultados, um de markdown / html / text.
X-Retain-Images
string
Política de retenção de imagens; passe none para remover imagens e economizar tokens.
X-No-Cache
boolean
Ignora o cache e obtém os resultados mais recentes.
Além disso, a busca chama o Reader para extrair o corpo de cada resultado, portanto todos os cabeçalhos de requisição 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 via GET (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 (sem Accept), 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:
Com Accept: application/json, retorna JSON estruturado:
  • data: array de resultados da busca (a quantidade é controlada por num; o exemplo acima retorna 5, mas apenas os 2 primeiros são mostrados aqui; content é o corpo completo, truncado no exemplo), cada um contendo title, url, content, usage.tokens.
  • Cobrança: cobrado pela soma dos usage.tokens de 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 no r.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

URL de destino
string
obrigatório
O endereço web a ler, anexado diretamente ao final do caminho do endpoint, p. ex. /v1/jina/reader/https://jina.ai.
file
file
O arquivo local a enviar; suporta PDF, Word / Excel / PPT, HTML, imagens, passado no campo file via POST como multipart/form-data.
url
string
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.
X-Respond-With
string
padrão:"markdown"
Formato de retorno, um de markdown / html / text / screenshot / pageshot.
X-Retain-Images
string
padrão:"all"
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.
X-With-Generated-Alt
boolean
Gera automaticamente texto descritivo para imagens sem alt.
Resume todos os links no final do corpo.
X-With-Images-Summary
boolean
Resume todas as imagens no final do corpo.
X-Engine
string
Motor de extração, um de browser / direct / cf-browser-rendering.
X-Target-Selector
string
Seletor CSS; extrai apenas a região correspondente da página.
X-Remove-Selector
string
Seletor CSS; remove os elementos correspondentes (p. ex. header, footer, nav).
X-Timeout
integer
Tempo limite de extração em segundos, máx. 180.
X-No-Cache
boolean
Ignora o cache e obtém o mais recente.
X-Md-Heading-Style
string
padrão:"atx"
Estilo de títulos Markdown, um de atx (#) / setext (sublinhado).
X-Md-Bullet-List-Marker
string
Marcador de lista com marcadores Markdown, um de - / + / *.
X-Md-Hr
string
Estilo da linha horizontal Markdown, p. ex. ***.
Estilo de links Markdown, um de inlined / referenced / discarded.
Os itens acima são apenas as opções comuns. Todos os cabeçalhos de requisição 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 em content.

3. Enviar um arquivo local (PDF / Word·Excel·PPT / HTML / imagem)

Example of Calling

Por padrão, retorna diretamente o corpo Markdown; adicione Accept: 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 via POST + 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 (sem Accept), retorna diretamente o corpo Markdown (ou seja, o conteúdo de data.content no JSON abaixo). Por exemplo, ao ler https://example.com:
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):
② Ler uma imagem (content é a descrição gerada pelo modelo de visão):
③ Enviar um arquivo local (enviando um artigo PDF; 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 HTTP 200 externo).
  • 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