Texteinbettungen erstellen

Wählen Sie ein auf ShareAI aktiviertes und durch Ihre Berechtigung erlaubtes Einbettungsmodell. Chat-Modelle können nicht als Ersatz für Einbettungsmodelle verwendet werden. Die Verfügbarkeit und unterstützten Optionen des Modells hängen vom konfigurierten Provider ab.

Eine Anfrage senden#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/embeddings" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_EMBEDDING_MODEL",
  "input": [
    "How do I connect a device?",
    "Where can I read my usage?"
  ],
  "encoding_format": "float"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_EMBEDDING_MODEL', 'input': ['How do I connect a device?', 'Where can I read my usage?'], 'encoding_format': 'float'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/embeddings', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/embeddings";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_EMBEDDING_MODEL",
  "input": [
    "How do I connect a device?",
    "Where can I read my usage?"
  ],
  "encoding_format": "float"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Anforderungsfelder#

Lesen Sie die Vektoren#

Lesen Sie den data Array und verwenden Sie jedes Ergebnis, um index seine Einbettung mit der Eingabe abzugleichen. Verwenden Sie dasselbe Modell und dieselben Dimensionen, wenn Sie Ihre Dokumente und Suchanfragen einbetten. Das Ergebnis enthält auch vom Provider gemeldete usage.

Stapel innerhalb der Grenzen#

Kombinierter Eingabetext ist auf 256 KiB begrenzt. Antworten sind synchron und auf 2 MiB begrenzt, daher können große Vektoren oder Stapel die Antwortgrenze überschreiten. Reduzieren Sie die Stapelgröße oder verwenden Sie unterstützte kleinere Dimensionen. Token-ID-Arrays werden nicht akzeptiert.

Authentifizierung und Verfügbarkeit#

Ein genehmigtes OAuth-Zugriffstoken kann den API-Schlüssel ersetzen. Konto-finanzierte Anfragen erfordern surcharge und einen akzeptierten Plan. Modell- und Providerbeschränkungen gelten weiterhin. Wenn das Modell nicht für Einbettungen aktiviert ist, wählen Sie ein verfügbares Einbettungsmodell; das Ändern der Berechtigung kann ein Modell nicht aktivieren.

Nutzung#

Einbettungen verbrauchen Eingabetokens. Überprüfen Sie die Modellpreise, bevor Sie einen großen Stapel ausführen, und verwenden Sie Konsolennutzung um Aktivitäten zu überprüfen. Behandeln Sie Validierungs-, Autorisierungs- und Verfügbarkeitsfehler, bevor Sie es erneut versuchen.