POST /openai/{region}/v1/images/generations ein Standardbild. Sende einen Prompt und ein Bildmodell aus deinem Workspace. Die Antwort liefert das Bild als b64_json.
Die Anfrage nutzt denselben Completion-API-Scope wie OpenAI Chat Completions und OpenAI Responses. Chat-Tools, Workflow-Nodes und imageGeneration in der Agent API sind eigene Oberflächen.
Bevor du startest
- API-Key: Erstelle einen persönlichen API-Key oder frage deinen Workspace-Admin nach einem Workspace-API-Key mit dem Scope Completion API.
Basis-URL
{region} muss eu oder us sein. Dieser Endpunkt akzeptiert kein global.
Parameter
Der Request-Body ist ein striktes Objekt. Zusätzliche Felder führen zu400.
Antwort
Eine erfolgreiche Antwort ist JSON mitcreated und data. data enthält ein Objekt mit b64_json und, wenn das Modell einen liefert, revised_prompt. Der HTTP-Body enthält kein usage-Objekt. Der Response-Header ld-model-id wiederholt die Modell-ID.
Die Generierung bricht nach 60 Sekunden ab. Ein Timeout liefert 504 mit The model did not respond in time. Please retry.
Erkennt Langdock, dass das Bildmodell den Prompt aus Sicherheitsgründen abgelehnt hat, liefert die Anfrage 400 mit The image generation request was blocked by the content filter of the Image Model. Abgelehnte Anfragen werden nicht abgerechnet. Nicht zugeordnete Provider-Fehler liefern 500.
Unterschiede zur OpenAI API
- Ein Bild pro Anfrage. Ein
n-Wert ungleich1wird abgelehnt. response_formatist nurb64_json. URL-Ausgabe wird nicht unterstützt.- HD- bzw. High-Resolution-Generierung wird nicht unterstützt.
- Es gibt keinen öffentlichen
/v1/images/edits-Endpunkt.
OpenAI-Python-Bibliothek verwenden
Lege Langdock als Basis-URL fest und verwendeimages.generate:
Rate Limits
Die Standardlimits sind 500 RPM (Anfragen pro Minute) und 150.000 TPM (Tokens pro Minute).- RPM gilt pro Workspace, Modell und API-Key.
- TPM teilen sich alle API-Keys, die dasselbe Modell in einem Workspace nutzen.
- In der Cloud können Admins unter Einstellungen > Workspace > Produkte > API die TPM für eigene Modelle setzen; sie begrenzt die geschätzte Größe einer einzelnen Anfrage.
- In Dedicated Deployments können Admins unter Einstellungen > Workspace > Produkte > API eigene Limits je Modell festlegen.
429 Too Many Requests. Erfolgreiche Antworten und Antworten mit Rate-Limit-Fehler enthalten die Response-Header x-ratelimit-limit-requests, x-ratelimit-limit-tokens, x-ratelimit-remaining-requests und x-ratelimit-remaining-tokens.
Die Nutzung persönlicher API-Keys zählt zusammen mit Chat- und Agenten-Nutzung zum effektiven persönlichen Budget des Mitglieds und zum Workspace-Ausgabenlimit. Die Nutzung von Workspace-API-Keys zählt zum API-Spend-Limit des Workspace. Bildgenerierungs-Aufrufe werden als Image-Generation-Nutzung abgerechnet. Siehe Persönliche API-Keys und Preise.
Browser- und CORS-Integrationen werden nicht unterstützt. Bewahre API-Keys serverseitig auf und rufe den Endpunkt über einen Server, eine CLI oder ein lokales Entwicklungstool auf. Weitere Informationen findest du in den Best Practices für API-Keys.