Skip to main content
POST
Generates one standard image as base64.
Erzeuge mit 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

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.
Der Pfadwert {region} muss eu oder us sein. Dieser Endpunkt akzeptiert kein global.

Parameter

Der Request-Body ist ein striktes Objekt. Zusätzliche Felder führen zu 400.

Antwort

Eine erfolgreiche Antwort ist JSON mit created 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.

Unterschiede zur OpenAI API

  • Ein Bild pro Anfrage. Ein n-Wert ungleich 1 wird abgelehnt.
  • response_format ist nur b64_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 verwende images.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 Dedicated Deployments können Admins unter Einstellungen > Workspace > Produkte > API eigene Limits je Modell festlegen.
Bei einer Überschreitung erhältst du 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.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Pfadparameter

region
enum<string>
Standard:eu
erforderlich

The region of the API to use. Must be eu or us.

Verfügbare Optionen:
eu,
us

Body

application/json
model
string
erforderlich

Image generation model ID from your workspace. GET /openai/{region}/v1/models lists chat models, not image models.

Minimum string length: 1
prompt
string
erforderlich

The image description.

Minimum string length: 1
n
enum<integer>

Number of images. Only 1 is supported.

Verfügbare Optionen:
1
size
enum<string>
Standard:auto

Output size. auto and 1024x1024 map to square, 1536x1024 to landscape, and 1024x1536 to portrait.

Verfügbare Optionen:
auto,
1024x1024,
1536x1024,
1024x1536
quality
enum<string>

Quality hint forwarded to the image model. Not every image model uses it.

Verfügbare Optionen:
auto,
low,
medium,
high
response_format
enum<string>

Response format. Only b64_json is supported.

Verfügbare Optionen:
b64_json
user
string

Optional end-user identifier. Accepted for OpenAI compatibility.

Antwort

OK

created
integer
erforderlich

Unix timestamp in seconds.

data
object[]
erforderlich
Required array length: 1 element