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

Bildgenerierung

Jobs für Text-zu-Bild anlegen

POST /api/v1/images/generations erzeugt ein bis vier Bilder aus einer Textbeschreibung. Erforderlicher Scope: images:generate.

JSON-Body

FeldTypPflichtStandardRegeln
promptstringja—getrimmt, 5–2.000 Zeichen
aspect_ratiostringnein1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5 oder 21:9
resolutionstringnein2K2K oder 4K
countintegernein11–4

Unbekannte Felder werden abgelehnt. Die öffentliche Anfrage kennt keine Optionen für Capability-Routing.

Credits

AuflösungCredits pro Bild
2K5
4K20

Reserviert wird der Preis pro Bild multipliziert mit count. Credits werden bei Annahme des Jobs atomar reserviert, bei Erfolg abgerechnet und bei endgültigem Fehlschlag freigegeben.

Authentifizierung und Idempotenz

API-Schlüssel, Scopes, Request-IDs und sichere Wiederholungen

Bildbearbeitung

Ein hochgeladenes Bild mit Anweisungen in natürlicher Sprache bearbeiten

Inhaltsverzeichnis

JSON-Body
Credits
cURL
JavaScript
Python
Ausgabeabmessungen
cURL
curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: manuscript-42-panel-a' \
  -H 'Prefer: wait=10' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"A labeled plant cell diagram","aspect_ratio":"4:3","resolution":"2K","count":1}'

JavaScript

const response = await fetch('https://sci-draw.com/api/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIDRAW_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ prompt: 'A labeled plant cell diagram' }),
});
const body = await response.json();

Python

import os, uuid, requests

response = requests.post(
    "https://sci-draw.com/api/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SCIDRAW_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"prompt": "A labeled plant cell diagram", "resolution": "2K"},
)
job = response.json()["data"]

Liefert 202, solange der Job wartet oder läuft, und 200, wenn das begrenzte Warten einen Endzustand erreicht. Antwortschema und Polling-Ablauf finden Sie unter Jobs.

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).

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