Skip to main content

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.
Wir haben die Jina-AI-API für zukünftige Erweiterungen ergänzt, daher kann die Verwendung leicht von der offiziellen nativen Implementierung abweichen.

Schnellstart

Ersetzen Sie API_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/embeddingshttps://aihubmix.com/v1/embeddings
  • Reranking (Rerank): https://api.jina.ai/v1/rerankhttps://aihubmix.com/v1/rerank
  • Tiefe Suche (DeepSearch): https://deepsearch.jina.ai/v1/chat/completionshttps://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 Ersatzadresse https://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 Parameter
  • jina-embeddings-v3: Textmodell, mehrsprachig, 1024 Dimensionen, 8K-Kontextfenster, 570M Parameter
  • jina-colbert-v2: Mehrsprachiges ColBERT-Modell, 8K-Token-Kontext, 560M Parameter, verwendet für Embedding und Reranking
  • jina-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 Format
  • binary_int8: Rückgabe als gepacktes int8-Binärformat. Effizienter für Speicherung, Suche und Übertragung
  • binary_uint8: Rückgabe als gepacktes uint8-Binärformat. Effizienter für Speicherung, Suche und Übertragung
  • base64: 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 Feld image 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

Erfolgreiche Antwort:
  • model: Name des verwendeten Modells
  • results: Array der Reranking-Ergebnisse, absteigend nach Relevanz-Score sortiert. Jedes Element enthält:
    • index: Indexposition im ursprünglichen Dokument-Array
    • relevance_score: Relevanzwert zwischen 0 und 1; höhere Werte bedeuten höhere Relevanz zur Anfrage
  • usage: Nutzungsstatistik
    • total_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 einfach api.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

Alle Dateien und Bilder müssen vorher im Data-URI-Format kodiert sein, mit einer maximalen Dateigröße von 10MB.

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-Rückgabebeispiel:
Python
Powered by Jina AIs s.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.
Darüber hinaus ruft die Suche für jeden Treffer den Reader auf, um den Textkörper zu extrahieren; daher gelten alle unter „Web-Reader (Reader)” aufgeführten X-*-Request-Header zur Steuerung der Textkörper-Formatierung auch für Suchergebnisse.

Aufruf-Beispiel

Suchanfrage und Parameter können als URL-Query-Parameter per GET (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 (ohne Accept) wird eine zusammengesetzte Markdown-Liste zurückgegeben, wobei jeder Eintrag nacheinander Titel, Quell-Link, Beschreibung (falls vorhanden) und Textkörper angibt:
Mit Accept: application/json wird strukturiertes JSON zurückgegeben:
  • data: Array der Suchergebnisse (die Anzahl wird durch num gesteuert; das Beispiel oben liefert 5, hier werden nur die ersten 2 gezeigt; content ist der vollständige Textkörper, im Beispiel gekürzt), jedes mit title, url, content, usage.tokens.
  • Abrechnung: Berechnet nach der Summe der usage.tokens aller 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 AIs r.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.
Link-Beibehaltungsstrategie, eines von all / none / text.
boolean
Generiert automatisch Beschreibungstext für Bilder ohne alt.
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. ***.
Markdown-Linkstil, eines von inlined / referenced / discarded.
Dies sind nur die gängigen Optionen. Alle von Jina unterstützten 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 in content 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 Sie Accept: 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

Per POST + 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 (ohne Accept) 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:
Mit 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):
② Bild lesen (content ist die vom Vision-Modell generierte Beschreibung):
③ Lokale Datei hochladen (Hochladen eines PDF-Papers; content ist lang, nur der Anfang wird gezeigt):
  • status: der von Jina upstream zurückgegebene Business-Statuscode; bei einem erfolgreichen Reader-Aufruf ist er 20000 (konsistent mit dem äußeren HTTP 200).
  • 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