Asynchrone Bilderzeugung

Was ist asynchrone Generierung

Für zeitaufwändige Bildgenerierungsanfragen unterstützt die Plattform den asynchronen Modus: nach dem Absenden wird sofort eine Task-ID zurückgegeben. Der Client erfragt das Endergebnis per Polling — keine dauerhafte Verbindung nötig.

Der asynchrone Modus eignet sich für Szenarien mit langer Generierungsdauer und verhindert Abbruch durch Request-Timeouts. Mehrere Tasks können auch im Batch gesendet werden.

Ablauf

Drei Schritte: Task senden → Status pollen → Ergebnis abrufen.

1. Task senden

POST an https://api.tvtapi.com/v1/images/async mit API-Key (Bearer-Auth) und Parametern:

curl -X POST https://api.tvtapi.com/v1/images/async \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"model-name","prompt":"Beschreibungstext"}'

Die Antwort enthält eine task_id — Ihr Nachweis für Abfrage und Download.

2. Status pollen

Task-Status per task_id abfragen:

curl https://api.tvtapi.com/v1/images/async/{task_id} \
  -H "Authorization: Bearer sk-xxxxxxxx"

Task-Zustände: queued, in_progress, succeeded, failed. Alle paar Sekunden pollen, bis der Zustand succeeded oder failed ist.

3. Bild herunterladen

Nach Erfolg das Bild abrufen über:

curl -L https://api.tvtapi.com/v1/images/async/{task_id}/content \
  -H "Authorization: Bearer sk-xxxxxxxx"

Dieser Endpunkt gibt eine 302-Weiterleitung zur tatsächlichen Speicher-URL. Jedes Bild hat ein Download-Limit; nach Ablauf wird der Task automatisch ungültig.

Auch im Web nutzbar

Wenn Sie keinen Code schreiben möchten, nutzen Sie die Bild-Werkbank unter /de-de/user/image-studio direkt. Die Werkbank hat einen integrierten Async-Schalter — nach Aktivierung pollt sie automatisch und zeigt die Ergebnisse an.

Hinweise

  • Die Async-Funktion muss vom Administrator aktiviert werden; das Benutzerkonto benötigt die entsprechende Berechtigung
  • Tasks haben eine Gültigkeitsdauer; abgelaufene Tasks können nicht heruntergeladen werden
  • Wenn ein Task zu lange in in_progress bleibt, markiert das System ihn automatisch als failed