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_progressbleibt, markiert das System ihn automatisch alsfailed