Zum Hauptinhalt springen
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. 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 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 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.
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