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
string
erforderlich
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
array
erforderlich
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.string
Standard:"float"
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
integer
Standard:"1024"
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
string
erforderlich
Modellname, verfügbare Modellliste:
jina-reranker-m0: Multimodaler mehrsprachiger Dokument-Reranker, 10K-Kontext, 2,4B Parameter, für die Sortierung visueller Dokumente
string
erforderlich
Suchanfrage-Text, der mit den Kandidatendokumenten verglichen wird
integer
Anzahl der zurückzugebenden relevantesten Dokumente. Standardmäßig werden alle Dokumente zurückgegeben.
array
erforderlich
Array der Kandidatendokumente, die nach Relevanz zur Anfrage neu geordnet werden
integer
Standard:"4096"
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
string
erforderlich
Modellname, verfügbare Modelle:
jina-deepsearch-v1: Standardmodell, sucht, liest und reasoniert, bis die beste Antwort gefunden ist
boolean
Standard:"true"
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.array
erforderlich
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
string
erforderlich
Suchanfrage. Muss beim Aufruf aus Code URL-kodiert werden.
integer
Standard:"5"
Maximale Anzahl zurückzugebender Ergebnisse; die tatsächliche Anzahl richtet sich nach den verfügbaren Ergebnissen.
string
Länder-/Regionscode, z. B.
US.string
Oberflächensprache, z. B.
en.string
Beschränkt die Suche auf bestimmte Sites; kann mehrfach übergeben werden, z. B.
site=jina.ai&site=github.com.string
Standard:"markdown"
Textkörperformat der Ergebnisse, eines von
markdown / html / text.string
Bild-Beibehaltungsstrategie; mit
none werden Bilder entfernt, um Tokens zu sparen.boolean
Ü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
string
erforderlich
Die zu lesende Webadresse, direkt an das Ende des Endpoint-Pfads angehängt, z. B.
/v1/jina/reader/https://jina.ai.file
Die hochzuladende lokale Datei; unterstützt PDF, Word / Excel / PPT, HTML, Bilder, per
POST als multipart/form-data im Feld file übergeben.string
Erforderlich beim Hochladen einer HTML-Datei, dient als Referenzadresse zum Auflösen relativer Links auf der Seite; beim Hochladen einer PDF nicht nötig.
string
Standard:"markdown"
Rückgabeformat, eines von
markdown / html / text / screenshot / pageshot.string
Standard:"all"
Bild-Beibehaltungsstrategie, eines von
all / none (Bilder entfernen, um Tokens zu sparen) / alt.string
Standard:"all"
Link-Beibehaltungsstrategie, eines von
all / none / text.boolean
Generiert automatisch Beschreibungstext für Bilder ohne
alt.boolean
Fasst alle Links am Ende des Textkörpers zusammen.
boolean
Fasst alle Bilder am Ende des Textkörpers zusammen.
string
Abruf-Engine, eines von
browser / direct / cf-browser-rendering.string
CSS-Selektor; extrahiert nur den passenden Seitenbereich.
string
CSS-Selektor; entfernt passende Elemente (z. B.
header, footer, nav).integer
Abruf-Timeout in Sekunden, max. 180.
boolean
Überspringt den Cache und ruft die neuesten Inhalte ab.
string
Standard:"atx"
Markdown-Überschriftenstil, eines von
atx (#) / setext (Unterstreichung).string
Markdown-Aufzählungszeichen, eines von
- / + / *.string
Markdown-Stil für horizontale Linien, z. B.
***.string
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