Bildbearbeitung

POST /api/v1/images/edits nimmt multipart/form-data entgegen. Erforderlicher Scope: images:edit.

Formularfelder

Feld	Typ	Pflicht	Standard	Regeln
`image`	file	ja	—	PNG, JPEG oder WebP; maximal 10 MiB und 40 Millionen dekodierte Pixel
`prompt`	string	ja	—	Bearbeitungsanweisung, 5–2.000 Zeichen
`aspect_ratio`	string	nein	vom Quellbild abhängig	dieselben öffentlichen Seitenverhältnisse wie bei der Generierung
`resolution`	string	nein	`2K`	`2K` oder `4K`
`count`	integer	nein	`1`	1–4

Dateisignaturen werden unabhängig vom angegebenen MIME-Typ geprüft. Ungültige, zu große oder unsichere Bilder führen zu 400 INVALID_REQUEST oder zu HTTP 413 mit demselben öffentlichen Code.

Credits

Auflösung	Credits pro Ausgabe
`2K`	10
`4K`	20

cURL

curl https://sci-draw.com/api/v1/images/edits \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: revise-figure-7-v2' \
  -F 'image=@figure.png;type=image/png' \
  -F 'prompt=Move the legend below the diagram and increase label contrast' \
  -F 'resolution=2K' \
  -F 'count=1'

JavaScript

const form = new FormData();
form.set('image', file);
form.set('prompt', 'Move the legend below the diagram');
const response = await fetch('https://sci-draw.com/api/v1/images/edits', {
  method: 'POST',

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer

Das hochgeladene Quellbild ist private Job-Eingabe und taucht in keiner Job- oder Log-Antwort auf. Idempotent doppelte Uploads werden verworfen; angenommene Quellbilder werden nach einem endgültigen Ergebnis gelöscht.

Formularfelder

Credits

cURL

JavaScript

Python

Inhaltsverzeichnis