Beschreibung
Wir haben die fünf Kern-Schnittstellen von Jina AI integriert, mit denen Sie einfach leistungsfähige intelligente Agenten aufbauen können. Diese Schnittstellen eignen sich vor allem für folgende Szenarien:- Vektor-Embeddings (Embeddings): Geeignet für multimodale RAG-Frage-Antwort-Szenarien wie intelligenten Kundenservice, intelligentes Recruiting und Wissensdatenbank-Q&A.
- Reranking (Rerank): Optimiert die Embedding-Kandidaten und ordnet sie nach Themenrelevanz neu, was die Antwortqualität großer Sprachmodelle deutlich verbessert.
- Tiefe Suche (DeepSearch): Führt tiefe Suche und Reasoning durch, bis die optimale Antwort gefunden wird – besonders geeignet für komplexe Aufgaben wie Forschungsprojekte und Produktlösungsentwicklung.
- Websuche (Search): Übergeben Sie eine Suchanfrage und erhalten Sie den sauberen Textkörper der Suchergebnisseite (SERP), direkt einsetzbar für webgestütztes Q&A und RAG mit einem LLM.
- Web-Reader (Reader): Übergeben Sie eine beliebige URL und erhalten Sie den sauberen Markdown-Textkörper der Seite – ideal, um Webinhalte für ein LLM abzugreifen.
Schnellstart
Ersetzen SieAPI_KEY durch AIHUBMIX_API_KEY und den Modell-Endpoint-Link – alle anderen Parameter und die Verwendung sind vollständig konsistent mit Jina AI offiziell.
Endpoint-Ersetzung:
-
Vektor-Embeddings (Embeddings):
https://jina.ai/embeddings→https://aihubmix.com/v1/embeddings -
Reranking (Rerank):
https://api.jina.ai/v1/rerank→https://aihubmix.com/v1/rerank -
Tiefe Suche (DeepSearch):
https://deepsearch.jina.ai/v1/chat/completions→https://aihubmix.com/v1/chat/completions -
Websuche (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>Falls die aktuelle primäre API-Adresse nicht verfügbar ist, ersetzen Sie die Domain in dieser Konfiguration durch die Ersatzadressehttps://api.inferera.com; der Pfad bleibt unverändert.
Embeddings
Jina AIs Embedding unterstützt sowohl reinen Text als auch multimodale Bilder und überzeugt insbesondere bei mehrsprachigen Aufgaben.Anfrage-Parameter
Modellname, verfügbare Modellliste:
jina-clip-v2: Multimodal, mehrsprachig, 1024 Dimensionen, 8K-Kontextfenster, 865M Parameterjina-embeddings-v3: Textmodell, mehrsprachig, 1024 Dimensionen, 8K-Kontextfenster, 570M Parameterjina-colbert-v2: Mehrsprachiges ColBERT-Modell, 8K-Token-Kontext, 560M Parameter, verwendet für Embedding und Rerankingjina-embeddings-v2-base-code: Für Code- und Dokumentensuche optimiertes Modell, 768 Dimensionen, 8K-Kontextfenster, 137M Parameter
Eingabetext oder -bild; unterschiedliche Modelle unterstützen unterschiedliche Eingabeformate. Für Text: ein Array von Strings; für multimodale Modelle: ein Array von Objekten mit den Feldern
text oder image.Rückgabedatentyp, mögliche Werte:
float: Standard, gibt ein Float-Array zurück. Häufigstes und am einfachsten zu nutzendes Formatbinary_int8: Rückgabe als gepacktes int8-Binärformat. Effizienter für Speicherung, Suche und Übertragungbinary_uint8: Rückgabe als gepacktes uint8-Binärformat. Effizienter für Speicherung, Suche und Übertragungbase64: Rückgabe als base64-kodierter String. Effizienter für die Übertragung
Anzahl der bei der Berechnung verwendeten Dimensionen. Unterstützte Werte:
- 1024
- 768
1. Multimodale Nutzung
2. Nutzung mit reinem Text
Geben Sie nur ein Array von Text-Strings an; das Feldimage wird nicht angegeben.
Rerank
Reranker zielt darauf ab, die Suchrelevanz und RAG-Genauigkeit zu verbessern. Er analysiert die ursprünglichen Suchergebnisse tiefgehend, berücksichtigt die subtilen Wechselwirkungen zwischen Anfrage und Dokumentinhalt und ordnet die Suchergebnisse neu, sodass die relevantesten Treffer ganz oben stehen.Anfrage-Parameter
Modellname, verfügbare Modellliste:
jina-reranker-m0: Multimodaler mehrsprachiger Dokument-Reranker, 10K-Kontext, 2,4B Parameter, für die Sortierung visueller Dokumente
Suchanfrage-Text, der mit den Kandidatendokumenten verglichen wird
Anzahl der zurückzugebenden relevantesten Dokumente. Standardmäßig werden alle Dokumente zurückgegeben.
Array der Kandidatendokumente, die nach Relevanz zur Anfrage neu geordnet werden
Maximale Chunk-Länge pro Dokument, gilt nur für Cohere (nicht von Jina unterstützt). Standardwert: 4096.
Lange Dokumente werden automatisch auf die angegebene Token-Anzahl gekürzt.
1. Multimodale Nutzung
Antwortbeschreibung
model: Name des verwendeten Modellsresults: Array der Reranking-Ergebnisse, absteigend nach Relevanz-Score sortiert. Jedes Element enthält:index: Indexposition im ursprünglichen Dokument-Arrayrelevance_score: Relevanzwert zwischen 0 und 1; höhere Werte bedeuten höhere Relevanz zur Anfrage
usage: Nutzungsstatistiktotal_tokens: Gesamtanzahl der in dieser Anfrage verarbeiteten Tokens
2. Text-Nutzung
Text-Reranking unterstützt sowohl mehrsprachige als auch reguläre Aufgaben, ähnlich der Embedding-Nutzung: Übergeben Sie ein Array.DeepSearch
DeepSearch kombiniert Such-, Lese- und Reasoning-Fähigkeiten, um die bestmögliche Antwort zu liefern. Vollständig kompatibel mit dem OpenAI Chat-API-Format — ersetzen Sie einfachapi.openai.com durch aihubmix.com, um loszulegen.
Der Stream gibt den Denkprozess zurück.
Anfrage-Parameter
Modellname, verfügbare Modelle:
jina-deepsearch-v1: Standardmodell, sucht, liest und reasoniert, bis die beste Antwort gefunden ist
Ob Streaming-Antworten aktiviert werden. Es wird dringend empfohlen, diese Option aktiviert zu lassen — DeepSearch-Anfragen können lange dauern; ohne Streaming kann es zu einem
524 Timeout-Fehler kommen.Liste der Konversationsnachrichten zwischen Nutzer und Assistent. Unterstützt mehrere Typen (modal) wie Text (.txt, .pdf), Bilder (.png, .webp, .jpeg) usw. Maximale Dateigröße: 10MB.
Multimodales Nachrichtenformat
DeepSearch unterstützt mehrere Nachrichtenformate, darunter reinen Text (message), Dateien (file) und Bilder (image). Beispiele für verschiedene Formate:
1. Reine Textnachricht
2. Nachricht mit Datei-Anhang
3. Nachricht mit Bild
Aufruf-Beispiel
Bitte beachten Sie: Der Python-Streaming-Aufruf von Jina AI auf der offiziellen Website liefert keine Antwort — verwenden Sie stattdessen unser Beispiel.Antwortbeschreibung
Die Antwort von DeepSearch wird standardmäßig gestreamt — sowohl Zwischenschritte des Reasonings als auch die endgültige Antwort. Der letzte Stream-Block enthält die finale Antwort, eine Liste der besuchten URLs und Details zur Token-Nutzung. Ohne Streaming wird nur die endgültige Antwort zurückgegeben — Zwischenschritte des „Denkens” werden weggelassen. Hinweis: Dieses JSON-Objekt unterscheidet sich vom Format, das Jina AI verwendet.Python
Websuche (Search)
Powered by Jina AIss.jina.ai: Übergeben Sie eine Suchanfrage und erhalten Sie den sauberen Textkörper der Suchergebnisseite (SERP), direkt einsetzbar für webgestütztes Q&A und RAG mit einem LLM. Der Endpoint unterstützt sowohl GET als auch POST.
Antwortformat (standardmäßig Markdown): Standardmäßig wird eine zusammengesetzte Markdown-Ergebnisliste zurückgegeben, direkt an ein LLM übergebbar; wenn Sie strukturierte Daten benötigen (
title / url / content und usage jedes Ergebnisses), fügen Sie den Request-Header Accept: application/json hinzu, um stattdessen JSON zu erhalten.Anfrage-Parameter
Suchanfrage. Muss beim Aufruf aus Code URL-kodiert werden.
Maximale Anzahl zurückzugebender Ergebnisse; die tatsächliche Anzahl richtet sich nach den verfügbaren Ergebnissen.
Länder-/Regionscode, z. B.
US.Oberflächensprache, z. B.
en.Beschränkt die Suche auf bestimmte Sites; kann mehrfach übergeben werden, z. B.
site=jina.ai&site=github.com.Textkörperformat der Ergebnisse, eines von
markdown / html / text.Bild-Beibehaltungsstrategie; mit
none werden Bilder entfernt, um Tokens zu sparen.Überspringt den Cache und ruft die neuesten Ergebnisse ab.
X-*-Request-Header zur Steuerung der Textkörper-Formatierung auch für Suchergebnisse.
Aufruf-Beispiel
Suchanfrage und Parameter können als URL-Query-Parameter perGET (empfohlen, am einfachsten) oder in einem JSON-Request-Body per POST übergeben werden; beide treffen denselben Endpoint und liefern dasselbe Ergebnis. Die Beispiele unten fügen Accept: application/json hinzu, um standardmäßig JSON zurückzugeben; entfernen Sie diesen Header, um eine saubere Markdown-Ergebnisliste zu erhalten (siehe das erste Curl-markdown-Beispiel).
Antwortbeschreibung
Standardmäßig (ohneAccept) wird eine zusammengesetzte Markdown-Liste zurückgegeben, wobei jeder Eintrag nacheinander Titel, Quell-Link, Beschreibung (falls vorhanden) und Textkörper angibt:
Accept: application/json wird strukturiertes JSON zurückgegeben:
data: Array der Suchergebnisse (die Anzahl wird durchnumgesteuert; das Beispiel oben liefert 5, hier werden nur die ersten 2 gezeigt;contentist der vollständige Textkörper, im Beispiel gekürzt), jedes mittitle,url,content,usage.tokens.- Abrechnung: Berechnet nach der Summe der
usage.tokensaller Ergebnisse; Jina berechnet offiziell mindestens 10000 Tokens pro Suche, sodass der Endbetrag der größere der beiden Werte ist, d. h.max(10000, Summe der Tokens).
Web-Reader (Reader)
Powered by Jina AIsr.jina.ai: Übergeben Sie eine beliebige URL und erhalten Sie den sauberen Markdown-Textkörper der Seite nach der Konvertierung – praktisch, um Webinhalte für ein LLM abzugreifen. Neben Webseiten werden auch Bilder (beschrieben durch ein Vision-Modell) und lokale Dateien (PDF, Word / Excel / PPT, HTML, Bilder) verarbeitet.
Antwortformat (standardmäßig Markdown): Standardmäßig wird direkt der saubere Markdown-Textkörper zurückgegeben, direkt an ein LLM übergebbar; wenn Sie strukturiertes JSON mit
usage und Feldern wie title / url benötigen (der Textkörper liegt in data.content), fügen Sie den Request-Header Accept: application/json hinzu.Anfrage-Parameter
Die zu lesende Webadresse, direkt an das Ende des Endpoint-Pfads angehängt, z. B.
/v1/jina/reader/https://jina.ai.Die hochzuladende lokale Datei; unterstützt PDF, Word / Excel / PPT, HTML, Bilder, per
POST als multipart/form-data im Feld file übergeben.Erforderlich beim Hochladen einer HTML-Datei, dient als Referenzadresse zum Auflösen relativer Links auf der Seite; beim Hochladen einer PDF nicht nötig.
Rückgabeformat, eines von
markdown / html / text / screenshot / pageshot.Bild-Beibehaltungsstrategie, eines von
all / none (Bilder entfernen, um Tokens zu sparen) / alt.Link-Beibehaltungsstrategie, eines von
all / none / text.Generiert automatisch Beschreibungstext für Bilder ohne
alt.Fasst alle Links am Ende des Textkörpers zusammen.
Fasst alle Bilder am Ende des Textkörpers zusammen.
Abruf-Engine, eines von
browser / direct / cf-browser-rendering.CSS-Selektor; extrahiert nur den passenden Seitenbereich.
CSS-Selektor; entfernt passende Elemente (z. B.
header, footer, nav).Abruf-Timeout in Sekunden, max. 180.
Überspringt den Cache und ruft die neuesten Inhalte ab.
Markdown-Überschriftenstil, eines von
atx (#) / setext (Unterstreichung).Markdown-Aufzählungszeichen, eines von
- / + / *.Markdown-Stil für horizontale Linien, z. B.
***.Markdown-Linkstil, eines von
inlined / referenced / discarded.X-*-Request-Header (einschließlich der gesamten X-Md-*-Familie) sowie POST-Body-Felder (wie das injizierte Skript injectPageScript) werden vom Gateway unverändert weitergeleitet; die vollständige Liste und Werte finden Sie in der offiziellen Jina-Dokumentation.
Multimodales Eingabeformat
Reader unterstützt drei Arten von Eingaben. Webseiten und Bilder werden direkt an das Ende des Endpoint-Pfads angehängt (GET); lokale Dateien werden per POST als multipart/form-data hochgeladen.
1. Webseiten-URL
2. Bild-URL (gibt eine visuelle Beschreibung zurück)
Die Bildadresse wird ebenfalls an das Ende des Pfads angehängt. Reader verwendet ein Vision-Modell, um eine Beschreibung (Caption, kein wörtliches OCR) für das Bild zu generieren, und legt sie incontent ab.
3. Lokale Datei hochladen (PDF / Word·Excel·PPT / HTML / Bild)
Aufruf-Beispiel
Standardmäßig wird direkt der Markdown-Textkörper zurückgegeben; fügen SieAccept: application/json hinzu, um strukturiertes JSON zu erhalten. Optionale Parameter werden als X-*-Request-Header übergeben und alle unverändert vom Gateway an Jina weitergeleitet (die vollständige Liste siehe „Anfrage-Parameter” oben).
1. Webseite lesen
2. Bild lesen
Curl
3. Lokale Datei hochladen
PerPOST + multipart/form-data hochladen; beim Hochladen von HTML müssen Sie zusätzlich das Feld url als Referenzadresse angeben. Die Abrechnung erfolgt wie beim Lesen einer URL.
Antwortbeschreibung
Standardmäßig (ohneAccept) wird direkt der Markdown-Textkörper zurückgegeben (d. h. der Inhalt von data.content im JSON unten). Zum Beispiel beim Lesen von https://example.com:
Accept: application/json wird strukturiertes JSON zurückgegeben. Die JSON-Struktur ist für alle drei Eingabetypen gleich: data ist ein einzelnes Objekt mit title / url / content / usage.tokens. Nachfolgend die echten Antworten für die drei Eingabetypen (wenn content zu lang ist, wird der Anfang beibehalten und der Rest mit … gekürzt).
① Webseite lesen (Lesen von https://example.com):
content ist die vom Vision-Modell generierte Beschreibung):
content ist lang, nur der Anfang wird gezeigt):
status: der von Jina upstream zurückgegebene Business-Statuscode; bei einem erfolgreichen Reader-Aufruf ist er20000(konsistent mit dem äußeren HTTP200).- Abrechnung: Berechnet nach
data.usage.tokens(die tatsächliche Anzahl der Ausgabe-Tokens), ohne Mindestbetrag (anders als der „Mindestbetrag von 10000 Tokens pro Suche” bei der Suche); bei extrem kurzem Inhalt wird eine minimale Abrechnungseinheit als Untergrenze angewendet, sodass niemals eine Nullabrechnung entsteht.
Zuletzt aktualisiert: 2026-07-03