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.
Démarrage rapide
Remplacez laAPI_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 secourshttps://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 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
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 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 in the 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 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 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. 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
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
Recherche web (Search)
Basé sur les.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
Texte de la requête. Doit être encodé en URL lors de l’appel depuis du code.
Nombre maximal de résultats à renvoyer ; le nombre réel dépend des résultats disponibles.
Code pays / région, p. ex.
US.Langue de l’interface, p. ex.
en.Restreint la recherche à des sites spécifiques ; peut être transmis plusieurs fois, p. ex.
site=jina.ai&site=github.com.Format du corps des résultats, l’un de
markdown / html / text.Politique de conservation des images ; transmettez
none pour supprimer les images et économiser des tokens.Ignore le cache et récupère les résultats les plus récents.
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 viaGET (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 (sansAccept), 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 :
Accept: application/json, renvoie du JSON structuré :
data: tableau des résultats de recherche (le nombre est contrôlé parnum; l’exemple ci-dessus renvoie 5 mais seuls les 2 premiers sont montrés ici ;contentest le corps complet, tronqué dans l’exemple), chacun contenanttitle,url,content,usage.tokens.- Facturation : facturé selon la somme des
usage.tokensde 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, soitmax(10000, somme des tokens).
Lecteur web (Reader)
Basé sur ler.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
L’adresse web à lire, ajoutée directement à la fin du chemin de l’endpoint, p. ex.
/v1/jina/reader/https://jina.ai.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.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.
Format de retour, l’un de
markdown / html / text / screenshot / pageshot.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.Génère automatiquement un texte descriptif pour les images sans
alt.Résume tous les liens à la fin du corps.
Résume toutes les images à la fin du corps.
Moteur d’extraction, l’un de
browser / direct / cf-browser-rendering.Sélecteur CSS ; extrait uniquement la région correspondante de la page.
Sélecteur CSS ; supprime les éléments correspondants (p. ex.
header, footer, nav).Délai d’expiration de l’extraction en secondes, max. 180.
Ignore le cache et récupère le contenu le plus récent.
Style de titres Markdown, l’un de
atx (#) / setext (soulignement).Marqueur de liste à puces Markdown, l’un de
- / + / *.Style de ligne horizontale Markdown, p. ex.
***.Style de liens Markdown, l’un de
inlined / referenced / discarded.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 danscontent.
3. Téléverser un fichier local (PDF / Word·Excel·PPT / HTML / image)
Example of Calling
Par défaut, renvoie directement le corps Markdown ; ajoutezAccept: 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 viaPOST + 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 (sansAccept), 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 :
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) :
content est la description générée par le modèle de vision) :
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 vaut20000(cohérent avec le HTTP200externe).- 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