Überblick

Die REST-API von SciDraw AI bietet stabile, job-basierte Endpunkte für Bildgenerierung, Bildbearbeitung und Formatkonvertierung.

Basis-URL: https://sci-draw.com

Maschinenlesbare Spezifikation: OpenAPI JSON · OpenAPI YAML

Beide Dateien beschreiben dieselbe API im OpenAPI-Format. Importieren Sie eine davon in Postman oder Insomnia, und alle Endpunkte samt Parametern sind vorausgefüllt; geben Sie sie einem Codegenerator, und Sie erhalten einen typisierten Client; reichen Sie sie an einen KI-Agenten weiter, und er kann die API aufrufen, ohne dass Sie die Anfrage von Hand schreiben. Die beiden Formate sind austauschbar — nehmen Sie das, was Ihr Werkzeug akzeptiert.

Schnellstart

1. Legen Sie unter Einstellungen → API-Schlüssel einen Schlüssel an und wählen Sie nur die Scopes, die Ihre Integration braucht.
2. Senden Sie den Schlüssel als Authorization: Bearer sd_....
3. Ergänzen Sie jede Erstellungsanfrage um einen eindeutigen Idempotency-Key.
4. Speichern Sie die zurückgegebene Job-ID und fragen Sie deren Location-URL ab, bis sie succeeded, failed oder canceled erreicht.

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

Eine Erstellungsanfrage liefert normalerweise 202 Accepted, ein Job-Objekt, einen Location-Header und Retry-After: 2. Mit Prefer: wait=10 warten Sie bis zu zehn Sekunden. Das Warten ändert die Job-Semantik nie: 200 kommt nur zurück, wenn der Job bereits abgeschlossen ist, sonst bleibt es bei 202.

Endpunkte

Alle Antworten sind JSON-Hüllen. Jede Antwort enthält eine X-Request-Id; geben Sie diese ID an, wenn Sie den Support kontaktieren. Als Dateiverweise werden ausschließlich Ausgabe-URLs und öffentliche Datei-IDs zurückgegeben. Das Capability-Routing verwaltet SciDraw AI.