Skip to main content

​
Überblick

Alle Generierungsanfragen folgen demselben grundlegenden Lebenszyklus: Job-Lebenszyklus-Diagramm

​
Job-Status

queued Job wartet in der Warteschlange auf Verarbeitung backlogged Job wartet hinter deinem aktuellen Concurrency-Limit scheduled Job wurde akzeptiert und für die Verarbeitung eingeplant processing Job wird gerade von einem Worker verarbeitet sampling Job generiert Ausgabe-Samples intermediate-complete Job hat ein Zwischenergebnis und kann weiter verarbeitet werden completed Job erfolgreich abgeschlossen, Ergebnis verfügbar in result.urls failed Job aufgrund eines Fehlers fehlgeschlagen, Details in result.error cancelled Job wurde durch Nutzer oder System abgebrochen

​
Fehler & Abbruch

Jobs können aus mehreren Gründen fehlschlagen:
  • API-Fehler des Generierungsdienstes
  • Ungültige Parameter oder nicht unterstützte Konfigurationen
  • Content-Moderation (NSFW-Filter)
  • Automatische Timeout-Erkennung (3 Minuten für gehostete Tools, 2 Stunden für externe Anbieter)
So brichst du einen Job ab: Sende eine DELETE-Anfrage an /jobs/{id}. Hinweis: Jobs können nur abgebrochen werden, solange ihr Status queued oder processing ist.
Wichtig: Fehlgeschlagene und abgebrochene Jobs werden nicht abgerechnet. Du zahlst nur für abgeschlossene Jobs.

​
Job-Status abfragen

Frage den Job-Status per GET-Anfrage an /jobs/{id} ab. Empfohlene Vorgehensweisen:
  • Poll alle 2–5 Sekunden, solange der Job aussteht (backlogged, queued, scheduled, processing, sampling oder intermediate-complete)
  • Verwende Exponential Backoff für länger laufende Jobs
  • Beende das Polling, sobald der Status completed, failed oder cancelled ist
  • Einige Jobs können während des processing-Status Vorschaubilder in den Antworten enthalten
Beispielimplementierung für Polling: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForJob(jobId) {
  const job = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return job.result;
}

​
Nächste Schritte

Webhooks

Erhalte Benachrichtigungen, wenn Jobs abgeschlossen sind

Rate Limits

Verstehe die API-Limits nach Plan-Tier

Model APIs

Entdecke alle verfügbaren Endpunkte und Parameter

API-Keys & Abrechnung

Erstelle und verwalte deine API-Keys