aisplice

API-Referenz

Embeddings

POST/v1/embeddings

Vektor-Embeddings im OpenAI-Format — text-embedding-3, jina-embeddings, voyage und entsprechende Modelle anderer Anbieter. Abgerechnet wird nach Eingabe-Tokens.

#Anfrageparameter

  • modelstringerforderlich

    Eine Embedding-Modell-ID, z. B. text-embedding-3-small.

  • inputstring | arrayerforderlich

    Ein String oder ein Array — die Antwort liefert die Vektoren in derselben Reihenfolge.

  • dimensionsintegeroptional

    Kürzt den Vektor bei Modellen, die Matryoshka-Dimensionen unterstützen.

  • encoding_formatstringoptional

    "float" (Standard) oder "base64" für einen kompakten Payload.

#Zugehörige Fehler

  • 400 invalid_request_errorFehlerhafter Body oder für dieses Modell nicht unterstützter Parameter.
  • 401Ungültiges oder fehlendes Bearer-Token. Auf diesem Pfad gibt es kein error.code — werten Sie den Status aus.
  • 402 insufficient_user_quotaDas Wallet-Guthaben deckt die vorab reservierte Schätzung nicht.
  • 429Drosselung pro Schlüssel. Leerer Body; warten Sie Retry-After ab. Ein 429, das insufficient_user_quota enthält, ist dagegen ein tägliches Ausgabenlimit.
  • 503 model_not_foundUnbekanntes Modell, oder derzeit bedient es kein funktionsfähiger Kanal.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

curl https://www.aisplice.store/v1/embeddings \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["hello world", "another sentence"]
  }'

#Antwort

response.json
{
  "object": "list",
  "model": "text-embedding-3-small",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, …]},
    {"object": "embedding", "index": 1, "embedding": [0.0154,  0.0007, …]}
  ],
  "usage": {"prompt_tokens": 8, "total_tokens": 8}
}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückAudioWeiterReranking