Skip to main content
POST
Creates embeddings for the given input text.
⚠️ Du nutzt unsere API in einem Dedicated Deployment? Ersetze einfach api.langdock.com durch die Base URL deines Deployments: <deployment-url>/api/public
Erstellt Embeddings für Text mit OpenAIs Embedding-Modellen. Dieser Endpunkt folgt der OpenAI API specification und die Anfragen werden an den Azure OpenAI-Endpunkt gesendet.
Um die API zu nutzen, fragst du deinen Workspace-Admin nach einem Workspace-API-Key mit dem Scope Embedding API. Persönliche API-Keys enthalten ausschließlich den Scope Completion API und können diesen Endpunkt nicht aufrufen.
Alle Parameter vom OpenAI Embeddings endpoint werden gemäß den OpenAI-Spezifikationen unterstützt, mit folgenden Ausnahmen:
  • model: Derzeit wird nur das text-embedding-ada-002 Modell unterstützt.
  • encoding_format: Unterstützt sowohl float als auch base64 Formate.

Rate Limits

Die Standard-Limits sind 500 RPM (Anfragen pro Minute) und 60.000 TPM (Tokens pro Minute).
  • RPM wird je Workspace, Modell und API-Key begrenzt.
  • TPM teilen sich alle API-Keys, die dasselbe Modell in einem Workspace verwenden.
  • In Dedicated Deployments können Admins unter Einstellungen > Workspace > Produkte > API eigene Limits je Modell festlegen.
Wenn du dein Rate Limit überschreitest, erhältst du eine 429 Too Many Requests Antwort.

Verwendung von OpenAI-kompatiblen Bibliotheken

Da das Anfrage- und Antwortformat dasselbe wie bei der OpenAI API ist, kannst du beliebte Bibliotheken wie die OpenAI Python library oder das Vercel AI SDK verwenden, um die Langdock API zu nutzen.

Beispiel mit der OpenAI Python-Bibliothek

Beispiel mit dem Vercel AI SDK in Node.js

Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Pfadparameter

region
enum<string>
erforderlich

The region of the API to use.

Verfügbare Optionen:
eu,
us

Body

application/json
input
erforderlich

Input text to get embeddings for, encoded as a string or array of tokens. To get embeddings for multiple inputs in a single request, pass an array of strings or array of tokens, e.g. ["text1", "text2"]. Each input must not exceed 8192 tokens in length.

model
erforderlich

ID of the model to use. You can use the List models API to see all of your available models, or see OpenAI's Model overview for descriptions of them.

encoding_format
enum<string>
Standard:float

The format to return the embeddings in. Can be either float or base64.

Verfügbare Optionen:
float,
base64
dimensions
integer

The number of dimensions the resulting output embeddings should have. Only supported in text-embedding-3 and later models.

Erforderlicher Bereich: x >= 1
user
string

A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse.

Antwort

OK

data
object[]
erforderlich

The list of embeddings generated by the model.

model
string
erforderlich

The name of the model used to generate the embedding.

object
enum<string>
erforderlich

The object type, which is always "list".

Verfügbare Optionen:
list
usage
object
erforderlich