Embeddings erstellen

Wandelt Text (oder, bei unterstützten Modellen, multimodale Inhalte) in Vektor-Embeddings um. Anfrage- und Antwortformat entsprechen der OpenAI-Embeddings-API und funktionieren direkt mit client.embeddings.create(). input akzeptiert einen einzelnen String oder ein Array von Strings.

POST/api/v1/embeddings

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Body

modelerforderlich

string

Das zu verwendende Embeddings-Modell, mit Provider-Präfix, z. B. "openai/text-embedding-3-small".

minLength: 1

Example: "openai/text-embedding-3-small"

inputerforderlich

string | string[]

Der zu embeddende Text. Akzeptiert einen einzelnen String oder ein Array von Strings, um mehrere Eingaben in einer Anfrage zu embedden. Manche Modelle akzeptieren zusätzlich strukturierte multimodale Inhaltselemente, die unverändert an den Upstream weitergegeben werden; die tatsächliche Unterstützung hängt vom Modell ab.

Example: "The quick brown fox"

encoding_format

string

Kodierungsformat, unverändert an den Upstream weitergegeben, ohne lokale Validierung; unterstützte Werte hängen vom Upstream ab.

Example: "float"

dimensions

integer

Die Anzahl der Dimensionen des Ausgabevektors, unverändert an den Upstream weitergegeben, ohne lokale Validierung; nur manche Modelle unterstützen benutzerdefinierte Dimensionen, das Verhalten bei fehlender Unterstützung (meist Ignorieren oder Fehler) entscheidet der Upstream.

provider

object

Provider-Routing-Einstellungen (order, only, ignore, allow_fallbacks, sort, …). Wird nur bei bestimmten Modellrouten weitergegeben und berücksichtigt; nicht unterstützte Routen verwerfen es stillschweigend und senden es nie an den Upstream.

POST /api/v1/embeddings

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/embeddings \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "The quick brown fox"
  }'

Antwortbeispiele

Erfolg. Gibt das OpenAI-kompatible Format zurück; data[] entspricht jedem Input in der Reihenfolge, und usage.cost ist der tatsächlich für diese Anfrage berechnete Betrag.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0023064255,
        -0.009327292,
        0.015797347
      ]
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 5,
    "total_tokens": 5,
    "cost": 1e-7
  }
}