/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.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
Eingabe zu lang
Eingabe zu lang
Teilen Sie lange Dokumente vor dem Embedding in Abschnitte auf.
Falscher Modelltyp
Falscher Modelltyp
Wählen Sie im Modellverzeichnis ein Embedding-fähiges Modell aus.
Vektordimensionen stimmen nicht überein
Vektordimensionen stimmen nicht überein
Verwenden Sie für einen Vektorindex dasselbe Modell und dieselben Dimensionen.
Fehlender API-Schlüssel
Fehlender API-Schlüssel
Senden Sie
Authorization: Bearer $COMETAPI_KEY.Fehlercodes und Retry-Strategie
400
400
Versuchen Sie es erst erneut, wenn die Eingabe, die model ID oder die Einstellung für die Dimensionen korrigiert wurde.
401
401
Versuchen Sie es erst erneut, wenn der API-Schlüssel vorhanden und gültig ist.
404
404
Überprüfen Sie vor einem erneuten Versuch die base URL, den Pfad und die model ID.
429
429
Wiederholen Sie den Versuch mit exponentiellem Backoff und reduzieren Sie die Batch-Größe oder die Parallelität.
500 or 503
500 or 503
Wiederholen Sie den Versuch mit Backoff bei vorübergehenden Provider- oder Dienstfehlern.
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.