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. Unterstützte Größen und Qualitätsstufen hängen vom Modell ab. Verfügbare Modelle umfassen OpenAI/Azure DALL·E und GPT-Image sowie Google Imagen — tauschen Sie den model-String aus, um den Anbieter zu wechseln. Verwenden Sie /v2/models/all, um alle Bildmodelle aufzulisten.

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": {},
  "moderation": "low"
}'

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": {},
  "moderation": "low"
}'

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": {},
        "moderation": "low"
    },
)

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": {},
        "moderation": "low"
    },
)

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": {},
    "moderation": "low"
  }),
});

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": {},
    "moderation": "low"
  }),
});

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, sofern das Modell einen unterstützt.

output_formatstringoptional

Kodierung des generierten Bildes, sofern das Modell die Wahl zulässt. Standard ist der Anbieterstandard.

parametersobjectoptional

Anbieterspezifisches Passthrough, das in die Upstream-Anfrage eingebunden wird, für Modelle mit zusätzlichen Optionen. Wird von allen anderen Modellen ignoriert.

moderationstringoptional

Moderationsstufe für die GPT-Image-Modelle von OpenAI: low (Standard) für weniger strenge Filterung oder auto für die Standardfilterung von OpenAI. Wird von allen anderen Modellen und Hosts ignoriert, auch von Azure.

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