Zum Hauptinhalt springen

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

model
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
input
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.
embedding_format
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
dimensions
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

model
string
erforderlich
Modellname, verfügbare Modellliste:
  • jina-reranker-m0: Multimodaler mehrsprachiger Dokument-Reranker, 10K-Kontext, 2,4B Parameter, für die Sortierung visueller Dokumente
query
string
erforderlich
Suchanfrage-Text, der mit den Kandidatendokumenten verglichen wird
top_n
integer
Anzahl der zurückzugebenden relevantesten Dokumente. Standardmäßig werden alle Dokumente zurückgegeben.
documents
array
erforderlich
Array der Kandidatendokumente, die nach Relevanz zur Anfrage neu geordnet werden
max_chunk_per_doc
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

model
string
erforderlich
Modellname, verfügbare Modelle:
  • jina-deepsearch-v1: Standardmodell, sucht, liest und reasoniert, bis die beste Antwort gefunden ist
stream
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.
messages
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

q
string
erforderlich
Suchanfrage. Muss beim Aufruf aus Code URL-kodiert werden.
num
integer
Standard:"5"
Maximale Anzahl zurückzugebender Ergebnisse; die tatsächliche Anzahl richtet sich nach den verfügbaren Ergebnissen.
gl
string
Länder-/Regionscode, z. B. US.
hl
string
Oberflächensprache, z. B. en.
site
string
Beschränkt die Suche auf bestimmte Sites; kann mehrfach übergeben werden, z. B. site=jina.ai&site=github.com.
X-Respond-With
string
Standard:"markdown"
Textkörperformat der Ergebnisse, eines von markdown / html / text.
X-Retain-Images
string
Bild-Beibehaltungsstrategie; mit none werden Bilder entfernt, um Tokens zu sparen.
X-No-Cache
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

Ziel-URL
string
erforderlich
Die zu lesende Webadresse, direkt an das Ende des Endpoint-Pfads angehängt, z. B. /v1/jina/reader/https://jina.ai.
file
file
Die hochzuladende lokale Datei; unterstützt PDF, Word / Excel / PPT, HTML, Bilder, per POST als multipart/form-data im Feld file übergeben.
url
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.
X-Respond-With
string
Standard:"markdown"
Rückgabeformat, eines von markdown / html / text / screenshot / pageshot.
X-Retain-Images
string
Standard:"all"
Bild-Beibehaltungsstrategie, eines von all / none (Bilder entfernen, um Tokens zu sparen) / alt.
Link-Beibehaltungsstrategie, eines von all / none / text.
X-With-Generated-Alt
boolean
Generiert automatisch Beschreibungstext für Bilder ohne alt.
Fasst alle Links am Ende des Textkörpers zusammen.
X-With-Images-Summary
boolean
Fasst alle Bilder am Ende des Textkörpers zusammen.
X-Engine
string
Abruf-Engine, eines von browser / direct / cf-browser-rendering.
X-Target-Selector
string
CSS-Selektor; extrahiert nur den passenden Seitenbereich.
X-Remove-Selector
string
CSS-Selektor; entfernt passende Elemente (z. B. header, footer, nav).
X-Timeout
integer
Abruf-Timeout in Sekunden, max. 180.
X-No-Cache
boolean
Überspringt den Cache und ruft die neuesten Inhalte ab.
X-Md-Heading-Style
string
Standard:"atx"
Markdown-Überschriftenstil, eines von atx (#) / setext (Unterstreichung).
X-Md-Bullet-List-Marker
string
Markdown-Aufzählungszeichen, eines von - / + / *.
X-Md-Hr
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