Jobs und begrenztes Warten

Bildoperationen sind dauerhafte Jobs. Die erste Antwort enthält das vollständige öffentliche Job-Objekt und Location: /api/v1/jobs/{job_id}.

Einen Job lesen

curl https://sci-draw.com/api/v1/jobs/job_012345 \
  -H 'Authorization: Bearer sd_YOUR_KEY'

Erforderlicher Scope: jobs:read. Jobs werden über ID und Kontozugehörigkeit zugleich gelesen. Ein fehlender Job und ein Job eines anderen Kontos liefern beide 404 JOB_NOT_FOUND.

Statusverlauf

Status	Bedeutung
`queued`	angenommen und wartet auf Ausführung
`processing`	Arbeit läuft
`succeeded`	`result.files` ist verfügbar
`failed`	`error` enthält einen stabilen öffentlichen Code samt Meldung
`canceled`	der Job wird nicht ausgeführt

Endzustände wechseln nie wieder. Fragen Sie noch laufende Jobs mit dem Retry-After-Wert der Erstellungsanfrage ab; derzeit werden zwei Sekunden empfohlen.

Die Erstellungs-Endpunkte akzeptieren Prefer: wait=N, wobei N eine ganze Zahl von 1 bis 30 ist. Erreicht der Job innerhalb des Fensters einen Endzustand, liefert der Endpunkt 200. Läuft er zum Zeitpunkt der Frist noch, kommt der aktuelle Job mit 202 zurück. Das eignet sich für interaktive Clients; Server-Integrationen sollten jedoch immer die Job-ID speichern und aufs Polling vorbereitet sein.

Erfolgreiches Ergebnis

{
  "success": true,
  "data": {
    "id": "job_012345",
    "object": "image_job",
    "type": "image_generation",
    "status": "succeeded",
    "created_at": "2026-08-07T12:00:00.000Z",
    "completed_at": "2026-08-07T12:00:41.000Z",
    "credits_reserved":

Keine Job-Antwort enthält übermittelte Prompts, Verweise auf Quellbilder, interne Bezeichner, Ausführungsdetails oder private Diagnosedaten.

Einen Job lesen

Statusverlauf

Begrenztes Warten

Erfolgreiches Ergebnis

Inhaltsverzeichnis