Passer au contenu principal

Description

Nous avons intégré les cinq interfaces principales de Jina AI, vous permettant de construire facilement de puissants agents intelligents. Ces interfaces sont principalement adaptées aux scénarios suivants :
  • Embeddings vectoriels (Embeddings) : applicables aux scénarios de questions-réponses RAG multimodaux, tels que le service client intelligent, le recrutement intelligent et les questions-réponses sur base de connaissances.
  • Reranking (Rerank) : en optimisant les résultats candidats des Embeddings et en les triant selon la pertinence thématique, on améliore significativement la qualité des réponses des grands modèles de langage.
  • Deep Search (DeepSearch) : effectue une recherche et un raisonnement approfondis jusqu’à trouver la meilleure réponse, particulièrement adapté aux tâches complexes telles que les projets de recherche et le développement de solutions produit.
  • Recherche web (Search) : transmettez une requête et obtenez le corps de texte propre de la page de résultats du moteur de recherche (SERP), prêt à être fourni directement à un LLM pour des questions-réponses connectées au web et du RAG.
  • Lecteur web (Reader) : transmettez n’importe quelle URL et obtenez le corps Markdown propre de cette page après conversion, idéal pour extraire du contenu web à fournir à un LLM.
Nous avons enrichi l’API Jina AI pour prendre en charge de futures extensions, l’utilisation peut donc différer légèrement de l’implémentation native officielle.

Démarrage rapide

Remplacez la API_KEY par AIHUBMIX_API_KEY et le lien d’endpoint du modèle ; les autres paramètres et l’utilisation sont entièrement cohérents avec ceux de Jina AI officiel. Remplacement de l’endpoint :
  • Embeddings vectoriels (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
  • Recherche web (Search) : https://s.jina.ai/?q= -> https://aihubmix.com/v1/jina/search?q=
  • Lecteur web (Reader) : https://r.jina.ai/<url> -> https://aihubmix.com/v1/jina/reader/<url>
    Si l’adresse principale actuelle de l’API est indisponible, remplacez le domaine de cette configuration par l’adresse de secours https://api.inferera.com ; conservez le chemin inchangé.

Embeddings

L’Embedding de Jina AI prend en charge à la fois le texte brut et les images multimodales, et excelle dans la gestion des tâches multilingues.

Request Parameters

model
string
requis
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
requis
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
défaut:"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
défaut:"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

Le Reranker vise à améliorer la pertinence des recherches et la précision du RAG. Il analyse en profondeur les résultats initiaux de la recherche, prend en compte les interactions subtiles entre la requête et le contenu des documents, et réordonne les résultats afin de placer les plus pertinents en tête.

Request Parameters

model
string
requis
Model name, available model list:
  • jina-reranker-m0:Multimodal multilingual document reranker, 10K context, 2.4B parameters, for visual document sorting
query
string
requis
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
requis
Array of candidate documents, will be reordered based on relevance to the query
max_chunk_per_doc
integer
défaut:"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 in the 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 supports both multilingual and regular tasks, similar to embedding usage, by passing in an array.

DeepSearch

DeepSearch combine des capacités de recherche, de lecture et de raisonnement pour obtenir la meilleure réponse possible. Il est entièrement compatible avec le format Chat API d’OpenAI — il suffit de remplacer api.openai.com par aihubmix.com pour démarrer. Le flux renvoie également le processus de réflexion.

Request Parameters

model
string
requis
Model name, available models:
  • jina-deepsearch-v1:Default model, search, read and reason until the best answer is found
stream
boolean
défaut:"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
requis
The list of conversation messages between the user and the assistant. Supports multiple types (modal) messages, such as text (.txt, .pdf), images (.png, .webp, .jpeg), etc. The maximum file size is 10MB

Multimodal Message Format

DeepSearch supports multiple types of message formats, which can include pure text (message), files (file), and images (image). The following 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

Please note that Jina AI’s Python streaming call on the official website will not have a response; please refer to 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 from the format used by Jina AI.
Python Return Example:
Python
Basé sur le s.jina.ai de Jina AI : transmettez une requête et obtenez le corps de texte propre de la page de résultats du moteur de recherche (SERP), prêt à être fourni directement à un LLM pour des questions-réponses connectées au web et du RAG. L’endpoint prend en charge à la fois GET et POST.
Format de réponse (Markdown par défaut) : par défaut, renvoie une liste de résultats en Markdown concaténée, prête à être fournie à un LLM ; lorsque vous avez besoin de données structurées (title / url / content et usage de chaque résultat), ajoutez l’en-tête de requête Accept: application/json pour obtenir du JSON à la place.

Request Parameters

q
string
requis
Texte de la requête. Doit être encodé en URL lors de l’appel depuis du code.
num
integer
défaut:"5"
Nombre maximal de résultats à renvoyer ; le nombre réel dépend des résultats disponibles.
gl
string
Code pays / région, p. ex. US.
hl
string
Langue de l’interface, p. ex. en.
site
string
Restreint la recherche à des sites spécifiques ; peut être transmis plusieurs fois, p. ex. site=jina.ai&site=github.com.
X-Respond-With
string
défaut:"markdown"
Format du corps des résultats, l’un de markdown / html / text.
X-Retain-Images
string
Politique de conservation des images ; transmettez none pour supprimer les images et économiser des tokens.
X-No-Cache
boolean
Ignore le cache et récupère les résultats les plus récents.
De plus, la recherche appelle le Reader pour extraire le corps de chaque résultat ; par conséquent, tous les en-têtes de requête X-* contrôlant le formatage du corps listés dans « Lecteur web (Reader) » s’appliquent également aux résultats de recherche.

Example of Calling

La requête et les paramètres peuvent être transmis en tant que paramètres de requête d’URL via GET (recommandé, le plus concis), ou dans un corps de requête JSON via POST ; les deux atteignent le même endpoint et renvoient le même résultat. Les exemples ci-dessous ajoutent Accept: application/json pour renvoyer du JSON par défaut ; supprimez cet en-tête pour obtenir une liste de résultats en Markdown propre (voir le premier exemple Curl-markdown).

Response Description

Par défaut (sans Accept), renvoie une liste Markdown concaténée, où chaque entrée indique successivement le titre, le lien source, la description (le cas échéant) et le corps :
Avec Accept: application/json, renvoie du JSON structuré :
  • data : tableau des résultats de recherche (le nombre est contrôlé par num ; l’exemple ci-dessus renvoie 5 mais seuls les 2 premiers sont montrés ici ; content est le corps complet, tronqué dans l’exemple), chacun contenant title, url, content, usage.tokens.
  • Facturation : facturé selon la somme des usage.tokens de chaque résultat ; Jina facture officiellement un minimum de 10000 tokens par recherche, de sorte que le montant final est le plus grand des deux, soit max(10000, somme des tokens).

Lecteur web (Reader)

Basé sur le r.jina.ai de Jina AI : transmettez n’importe quelle URL et obtenez le corps Markdown propre de cette page après conversion, pratique pour extraire du contenu web à fournir à un LLM. Outre les pages web, il prend aussi en charge l’analyse d’images (décrites par un modèle de vision) et de fichiers locaux (PDF, Word / Excel / PPT, HTML, images).
Format de réponse (Markdown par défaut) : par défaut, renvoie directement le corps Markdown propre, prêt à être fourni à un LLM ; lorsque vous avez besoin de JSON structuré avec usage et des champs comme title / url (le corps se trouve dans data.content), ajoutez l’en-tête de requête Accept: application/json.

Request Parameters

URL cible
string
requis
L’adresse web à lire, ajoutée directement à la fin du chemin de l’endpoint, p. ex. /v1/jina/reader/https://jina.ai.
file
file
Le fichier local à téléverser ; prend en charge PDF, Word / Excel / PPT, HTML, images, transmis dans le champ file via POST en tant que multipart/form-data.
url
string
Obligatoire lors du téléversement d’un fichier HTML, utilisé comme adresse de référence pour résoudre les liens relatifs de la page ; inutile lors du téléversement d’un PDF.
X-Respond-With
string
défaut:"markdown"
Format de retour, l’un de markdown / html / text / screenshot / pageshot.
X-Retain-Images
string
défaut:"all"
Politique de conservation des images, l’une de all / none (supprimer les images pour économiser des tokens) / alt.
Politique de conservation des liens, l’une de all / none / text.
X-With-Generated-Alt
boolean
Génère automatiquement un texte descriptif pour les images sans alt.
Résume tous les liens à la fin du corps.
X-With-Images-Summary
boolean
Résume toutes les images à la fin du corps.
X-Engine
string
Moteur d’extraction, l’un de browser / direct / cf-browser-rendering.
X-Target-Selector
string
Sélecteur CSS ; extrait uniquement la région correspondante de la page.
X-Remove-Selector
string
Sélecteur CSS ; supprime les éléments correspondants (p. ex. header, footer, nav).
X-Timeout
integer
Délai d’expiration de l’extraction en secondes, max. 180.
X-No-Cache
boolean
Ignore le cache et récupère le contenu le plus récent.
X-Md-Heading-Style
string
défaut:"atx"
Style de titres Markdown, l’un de atx (#) / setext (soulignement).
X-Md-Bullet-List-Marker
string
Marqueur de liste à puces Markdown, l’un de - / + / *.
X-Md-Hr
string
Style de ligne horizontale Markdown, p. ex. ***.
Style de liens Markdown, l’un de inlined / referenced / discarded.
Les éléments ci-dessus ne sont que les options courantes. Tous les en-têtes de requête X-* pris en charge par Jina (y compris toute la famille X-Md-*) ainsi que les champs de corps POST (comme le script injecté injectPageScript) sont transmis tels quels par la passerelle ; pour la liste complète et les valeurs, reportez-vous à la documentation officielle de Jina.

Multimodal Input Format

Reader prend en charge trois types d’entrée. Les pages web et les images sont ajoutées directement à la fin du chemin de l’endpoint (GET) ; les fichiers locaux sont téléversés via POST en tant que multipart/form-data.

1. URL de page web

2. URL d’image (renvoie une description visuelle)

L’adresse de l’image est également ajoutée à la fin du chemin. Reader utilise un modèle de vision pour générer une description (une légende, pas un OCR mot à mot) de l’image et la place dans content.

3. Téléverser un fichier local (PDF / Word·Excel·PPT / HTML / image)

Example of Calling

Par défaut, renvoie directement le corps Markdown ; ajoutez Accept: application/json pour obtenir du JSON structuré. Les paramètres optionnels sont transmis en tant qu’en-têtes de requête X-* et sont tous transmis tels quels par la passerelle à Jina (pour la liste complète, voir « Request Parameters » ci-dessus).

1. Lire une page web

2. Lire une image

Curl

3. Téléverser un fichier local

Téléversez via POST + multipart/form-data ; lors du téléversement de HTML, vous devez également inclure le champ url comme adresse de référence. La facturation est identique à la lecture d’une URL.

Response Description

Par défaut (sans Accept), renvoie directement le corps Markdown (c’est-à-dire le contenu de data.content dans le JSON ci-dessous). Par exemple, en lisant https://example.com :
Avec Accept: application/json, renvoie du JSON structuré. La structure du JSON est identique pour les trois types d’entrée : data est un objet unique contenant title / url / content / usage.tokens. Ci-dessous, les réponses réelles pour les trois types d’entrée (lorsque content est trop long, le début est conservé et le reste est abrégé par ). ① Lire une page web (lecture de https://example.com) :
② Lire une image (content est la description générée par le modèle de vision) :
③ Téléverser un fichier local (téléversement d’un article PDF ; content est long, seul le début est montré) :
  • status : le code de statut métier renvoyé par Jina en amont ; lors d’un appel reader réussi, il vaut 20000 (cohérent avec le HTTP 200 externe).
  • Facturation : facturé selon data.usage.tokens (le nombre réel de tokens de sortie), sans montant minimum (contrairement au « minimum de 10000 tokens par recherche » de la recherche) ; pour un contenu extrêmement court, une unité de facturation minimale est appliquée comme plancher, de sorte qu’une facturation nulle ne se produit jamais.

Dernière mise à jour : 2026-07-03