Bild erstellen · DeutschlandGPT

Generiert ein oder mehrere Bilder aus einem Textprompt. Kompatibel mit der OpenAI /v1/images/generations API.

Bilder werden als base64-kodierte Daten (b64_json) zurückgegeben. Die Kodierung ist PNG für OpenAI/Azure-Modelle und folgt output_format (Standard JPEG) für fal.ai-Modelle. Unterstützte Größen und Qualitätsstufen hängen vom Modell ab. Verfügbare Modelle umfassen OpenAI/Azure DALL·E und GPT-Image, Google Imagen sowie fal.ai-Modelle (flux-schnell, flux-dev, flux-pro-1.1, ideogram-v3, recraft-v3) — tauschen Sie den model-String aus, um den Anbieter zu wechseln. Verwenden Sie /v2/models/all, um alle Bildmodelle aufzulisten.

fal.ai-Modelle akzeptieren zusätzliche Parameter (guidance_scale, style, rendering_speed, enable_safety_checker, …) über das parameters-Passthrough; diese werden von OpenAI/Azure- und Google-Modellen ignoriert.

POSThttps://api.deutschlandgpt.de/v2/images/generationsAusprobieren

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/images/generations \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A serene mountain lake at sunset, pine trees reflected in calm water, photorealistic",
  "model": "dall-e-3",
  "n": 1,
  "quality": "standard",
  "size": "1024x1024",
  "response_format": "b64_json",
  "seed": 0,
  "output_format": "png",
  "parameters": {}
}'

curl https://api.deutschlandgpt.de/v2/images/generations \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A serene mountain lake at sunset, pine trees reflected in calm water, photorealistic",
  "model": "dall-e-3",
  "n": 1,
  "quality": "standard",
  "size": "1024x1024",
  "response_format": "b64_json",
  "seed": 0,
  "output_format": "png",
  "parameters": {}
}'

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/images/generations",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "prompt": "A serene mountain lake at sunset, pine trees reflected in calm water, photorealistic",
        "model": "dall-e-3",
        "n": 1,
        "quality": "standard",
        "size": "1024x1024",
        "response_format": "b64_json",
        "seed": 0,
        "output_format": "png",
        "parameters": {}
    },
)

print(response.json())

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/images/generations",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "prompt": "A serene mountain lake at sunset, pine trees reflected in calm water, photorealistic",
        "model": "dall-e-3",
        "n": 1,
        "quality": "standard",
        "size": "1024x1024",
        "response_format": "b64_json",
        "seed": 0,
        "output_format": "png",
        "parameters": {}
    },
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "prompt": "A serene mountain lake at sunset, pine trees reflected in calm water, photorealistic",
    "model": "dall-e-3",
    "n": 1,
    "quality": "standard",
    "size": "1024x1024",
    "response_format": "b64_json",
    "seed": 0,
    "output_format": "png",
    "parameters": {}
  }),
});

console.log(await response.json());

const response = await fetch('https://api.deutschlandgpt.de/v2/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "prompt": "A serene mountain lake at sunset, pine trees reflected in calm water, photorealistic",
    "model": "dall-e-3",
    "n": 1,
    "quality": "standard",
    "size": "1024x1024",
    "response_format": "b64_json",
    "seed": 0,
    "output_format": "png",
    "parameters": {}
  }),
});

console.log(await response.json());

Anfrage-Body

promptstringerforderlich

Textbeschreibung des gewünschten Bildes. Maximal 1000 Zeichen.

modelstringoptional

Zu verwendendes Modell. Standard: dall-e-3. Verwenden Sie /v2/models, um Bildmodelle aufzulisten.

nintegeroptional

Anzahl der zu generierenden Bilder.

qualitystringoptional

Bildqualität. Gängige Werte: standard, hd. Unterstützte Werte hängen vom Modell ab.

sizestringoptional

Bildabmessungen. Gängige Werte: 1024x1024, 1792x1024, 1024x1792. Unterstützte Werte hängen vom Modell ab.

response_formatstringoptional

Antwortformat. Derzeit wird nur b64_json unterstützt.

seedintegeroptional

Optionaler Seed für reproduzierbare Generierung. Wird von den meisten fal.ai-Modellen unterstützt.

output_formatstringoptional

Kodierung des generierten Bildes (nur fal.ai-Modelle). Standard ist der Anbieterstandard.

parametersobjectoptional

Anbieterspezifisches Passthrough, das in die Upstream-Anfrage eingebunden wird (nur fal.ai). z.B. { "guidance_scale": 3.5, "style": "realistic_image", "enable_safety_checker": true }. Wird von OpenAI/Azure/Vertex-Modellen ignoriert.

Antwort

200application/json

{
  "created": 0,
  "data": [
    {
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ],
  "usage": {
    "imageCount": 0,
    "quality": "string",
    "dimension": "string",
    "costInEuro": 0
  }
}

{
  "created": 0,
  "data": [
    {
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ],
  "usage": {
    "imageCount": 0,
    "quality": "string",
    "dimension": "string",
    "costInEuro": 0
  }
}

Antwort der Bildgenerierung

createdinteger

Unix-Zeitstempel

dataobject[]

b64_jsonstring

Base64-kodierte Bilddaten

revised_promptstring

Der vom Modell überarbeitete Prompt (nur DALL-E 3)

usageobject

imageCountinteger

qualitystring

dimensionstring

costInEuronumber

Tatsächliche Kosten in EUR für diese Anfrage

Statuscodes

200

Antwort der Bildgenerierung

object

400

Ungültige Qualität oder Größe für dieses Modell

401

Nicht autorisiert

402

Nicht genügend Guthaben

404

Modell nicht gefunden