Embeddings

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/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

Nicht unterstützt. Das gesamte Objekt wird ignoriert und vor der Weiterleitung entfernt; es kann weder Upstream noch Preisstufe auswählen.

POST /v1/embeddings

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/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 den Eingaben in ihrer Reihenfolge. usage.cost ist der für diese Anfrage berechnete USD-Betrag. Die opake BazaarLink-Anfrage-ID in der Antwort stimmt mit x-request-id überein; verwenden Sie sie mit GET /v1/generation. Statistiken können erst Sekunden später verfügbar sein; wiederholen Sie 404 kurzzeitig. Bei nicht gestreamten Antworten steht dieselbe ID auch in x-generation-id.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "id": "85e6f35c71a31f19-SJC",
  "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
  }
}