LogoLogoAPI-Dokumentation
LogoLogoAPI-Dokumentation
Startseite
ÜberblickAuthentifizierung und IdempotenzBildgenerierungBildbearbeitungBildkonvertierungDiagrammerzeugungJobs und begrenztes WartenCreditsFehlerRatenbegrenzung und ParallelitätAPI-Changelog
API-Dokumentation

Bildbearbeitung

Ein hochgeladenes Bild mit Anweisungen in natürlicher Sprache bearbeiten

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

Formularfelder

FeldTypPflichtStandardRegeln
imagefileja—PNG, JPEG oder WebP; maximal 10 MiB und 40 Millionen dekodierte Pixel
promptstringja—Bearbeitungsanweisung, 5–2.000 Zeichen
aspect_ratiostringneinvom Quellbild abhängigdieselben öffentlichen Seitenverhältnisse wie bei der Generierung
resolutionstringnein2K2K oder 4K
countintegernein11–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ösungCredits pro Ausgabe
2K10
4K20

cURL

Bildgenerierung

Jobs für Text-zu-Bild anlegen

Bildkonvertierung

Bilder nach SVG, PPTX, PNG, PDF oder TIFF konvertieren

Inhaltsverzeichnis

Formularfelder
Credits
cURL
JavaScript
Python
Ausgabeabmessungen
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',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"prompt": "Move the legend below the diagram"},
    )

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.

Ausgabeabmessungen

2K und 4K sind Größenstufen, keine festen Kantenlängen. Die Tabelle zeigt die tatsächlichen Pixelmaße. Nicht unterstützte Seitenverhältnisse führen vor Auftragserstellung oder Credit-Reservierung zu HTTP 400 (INVALID_REQUEST). Ohne aspect_ratio muss das Quellverhältnis bei Bearbeitungen zwischen 1:3 und 3:1 liegen und zur Größenstufe passen (mindestens 6 Millionen Pixel für 4K); andernfalls ein unterstütztes Ausgabeverhältnis angeben.

aspect_ratio2K4K
1:12048×20482880×2880
16:92560×14403840×2160
9:161440×25602160×3840
4:32304×17283264×2448
3:41728×23042448×3264
3:22496×16643504×2336
2:31664×24962336×3504
5:42240×17923200×2560
4:51792×22402560×3200
21:93136×13443808×1632