Bild bearbeiten
Bearbeitet ein vorhandenes Bild anhand eines Prompts, optional mit einer Inpainting-Maske. Kompatibel mit der OpenAI /v1/images/edits API — als multipart/form-data senden (nicht JSON).
Nur als bearbeitbar gekennzeichnete Bildmodelle funktionieren hier: Rufen Sie /v2/models/all auf und verwenden Sie ein Modell, dessen supports_edits true ist. Jedes solche Modell meldet zusätzlich einen edit-Block mit supports_mask und max_input_images. Eine mask wird nur von Modellen akzeptiert, deren edit.supports_mask true ist (OpenAI GPT-Image, FLUX Inpaint/Fill, Ideogram); Modelle mit natürlichsprachlicher bzw. Mehrfachreferenz-Bearbeitung (Gemini Flash Image, FLUX.2, Seedream, Nano Banana) lehnen eine Maske mit 400 ab. Bilder werden als base64-kodierte Daten (b64_json) zurückgegeben.
Anbieterspezifische Parameter (z. B. OpenAI input_fidelity/background, fal strength/guidance_scale) können im JSON-Feld parameters gesendet werden; OpenAI background, input_fidelity und output_format können auch als eigene Formularfelder gesendet werden.
https://api.deutschlandgpt.de/v2/images/editsBeispielaufruf
curl https://api.deutschlandgpt.de/v2/images/edits \
-X POST \
-H "Authorization: Bearer $DGPT_API_KEY"curl https://api.deutschlandgpt.de/v2/images/edits \
-X POST \
-H "Authorization: Bearer $DGPT_API_KEY"import os, requests
response = requests.post(
"https://api.deutschlandgpt.de/v2/images/edits",
headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)
print(response.json())import os, requests
response = requests.post(
"https://api.deutschlandgpt.de/v2/images/edits",
headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)
print(response.json())const response = await fetch('https://api.deutschlandgpt.de/v2/images/edits', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
},
});
console.log(await response.json());const response = await fetch('https://api.deutschlandgpt.de/v2/images/edits', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
},
});
console.log(await response.json());Antwort
{
"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 Bildbearbeitung
createdintegerUnix-Zeitstempel
dataobject[]b64_jsonstringBase64-kodierte Daten des bearbeiteten Bilds
revised_promptstringDer vom Modell überarbeitete Prompt (sofern vorhanden)
usageobjectimageCountintegerqualitystringdimensionstringcostInEuronumberTatsächliche Kosten in EUR für diese Anfrage
Statuscodes
Antwort der Bildbearbeitung
objectFehlendes Bild/Prompt, eine Maske bei einem maskenlosen Modell oder zu viele Eingabebilder
Nicht autorisiert
Unzureichendes Guthaben
Modell nicht gefunden oder unterstützt keine Bearbeitung