Skip to main content
Verwenden Sie CometAPI Embeddings, wenn Ihre App Vektoren für semantische Suche, Clustering, Empfehlungen oder Retrieval benötigt. Senden Sie Text an /v1/embeddings, speichern Sie den zurückgegebenen Vektor und durchsuchen Sie ihn mit Ihrer Vektordatenbank.

Ein Embedding erstellen

Verwenden Sie eine Embedding-fähige model ID von der Models-Seite oder aus dem model directory. Die folgenden Beispiele rufen die OpenAI-kompatible Embeddings API auf.
Diese Beispiele verwenden den Platzhalter your-embedding-model-id. Ersetzen Sie ihn durch eine verfügbare Embedding-model ID von der Models-Seite oder aus dem model directory, bevor Sie die Anfrage ausführen.
Öffnen Sie Create embeddings, um den Playground und das Endpoint-Schema zu verwenden.

Antwortbeispiel

Eine erfolgreiche Antwort kann so aussehen. Die Antwort enthält einen Vektor für jedes Eingabeelement; der folgende Vektor ist aus Gründen der Lesbarkeit gekürzt:

Batch-Eingabe

Senden Sie ein Array von Strings, wenn Sie mehrere Vektoren mit einer Anfrage erhalten möchten:
cURL

Beispielhafte model records

Diese Beispielantwort des Modellkatalogs zeigt das Envelope von /api/models und die Datensatzform eines OpenAI-kompatiblen Embeddings-Modells. Einige Embedding-Datensätze verwenden ein leeres model_type; wählen Sie ein Embedding-Modell anhand der ID und der Endpoint-Unterstützung, anstatt sich nur auf dieses Feld zu verlassen.
cURL

Häufige Fehler

Teilen Sie lange Dokumente vor dem Embedding in Abschnitte auf.
Wählen Sie im Modellverzeichnis ein Embedding-fähiges Modell aus.
Verwenden Sie für einen Vektorindex dasselbe Modell und dieselben Dimensionen.
Senden Sie Authorization: Bearer $COMETAPI_KEY.

Fehlercodes und Retry-Strategie

Versuchen Sie es erst erneut, wenn die Eingabe, die model ID oder die Einstellung für die Dimensionen korrigiert wurde.
Versuchen Sie es erst erneut, wenn der API-Schlüssel vorhanden und gültig ist.
Überprüfen Sie vor einem erneuten Versuch die base URL, den Pfad und die model ID.
Wiederholen Sie den Versuch mit exponentiellem Backoff und reduzieren Sie die Batch-Größe oder die Parallelität.
Wiederholen Sie den Versuch mit Backoff bei vorübergehenden Provider- oder Dienstfehlern.
Implementierungsmuster finden Sie unter Fehlercodes und Retry-Strategie und Ratenlimits und Parallelität.

Preise und Modellverzeichnis

Modellseite

Lesen Sie, wie CometAPI model IDs in der Dokumentation verfügbar macht.

Modellverzeichnis

Durchsuchen Sie Modellverfügbarkeit und Funktionen.

Preise

Prüfen Sie die Preise, bevor Sie ein Modell aufrufen.
Zuletzt geändert am 23. Juni 2026