Video & Materialien
Video-Status abrufen
Status und Ergebnis einer Video-Aufgabe abrufen
GET /v1/videos/generations/{id} ist ein Kompatibilitäts-Endpunkt. Er wird für bestehende Integrationen weiterhin unterstützt und gibt das Ergebnis im gleichen Format wie GET /v1/tasks/{id} zurück. Neue Integrationen sollten GET /v1/tasks/{id} abfragen; siehe Task-Status abrufen.
Pfad-Parameter
Die Task-ID, die von der Video-Erstellungsanfrage zurückgegeben wurde. id und task_id bezeichnen dieselbe Aufgabe.
Eine Statusabfrage gibt HTTP 200 zurück, auch wenn die Aufgabe fehlgeschlagen ist; prüfen Sie status. Eine abgelaufene oder nicht verfügbare Aufgabe gibt 404 async_task_not_found zurück. Eine Aufgabe, die nicht zu Ihrem Workspace gehört, gibt 403 task_not_owned zurück. 503 async_task_owner_unavailable ist ein temporärer Fehler: Wiederholen Sie die Anfrage.
Antwort
Felder, die Ergebnisse, Fehler, Zeitstempel und das Modell beschreiben, werden zurückgegeben, sobald sie für die Aufgabe verfügbar sind.
Task-ID.
Dieselbe Task-ID wie id.
Status-URL für diese Aufgabe. Fragen Sie GET /v1/tasks/{id} mit der id ab.
Abrechnungs-Transaktions-ID nach Abschluss. Diese ist von der Task-ID getrennt.
Task-Status: pending, processing, completed, failed.
Optionaler Fortschritt von 0 bis 100. Wird nur zurückgegeben, wenn ein tatsächlicher Fortschrittswert verfügbar ist; verwenden Sie status, um den Abschluss zu bestimmen.
URL des generierten Videos (nach Abschluss). Dies ist eine TokenLab-Medien-Ergebnis-URL, die 30 Tage lang gültig bleibt; siehe Ergebnis herunterladen. Fehlgeschlagene und unvollständige Aufgaben geben keine Video-URL zurück.
URL des zuletzt generierten Frames, wenn Sie dies mit return_last_frame angefordert haben und das Modell dies unterstützt.
Einzelnes Videoergebnis mit url, duration, width und height, sofern verfügbar.
Mehrere Videoergebnisse, wenn die Aufgabe mehr als eine Ausgabe zurückgibt.
Grund für das Scheitern der Aufgabe (nur wenn status auf failed steht): ein String oder ein Objekt mit message und, falls bekannt, type, code, param und retryable. Eine fehlgeschlagene Aufgabe kann auch error_details enthalten; siehe Async Jobs und Polling.
Speicherstatus des Videos: days und items, jeweils mit url, kind, status und expires_at. Kann fehlen, wenn der Status nicht rechtzeitig bekannt ist; die URL funktioniert weiterhin.
Zeitstempel der Erstellung.
Zeitstempel der letzten Aktualisierung.
Modell, das für die Aufgabe verwendet wurde.
Anfrage
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Antwort
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "veo3.1",
"created": 1706000000,
"updated": 1706000000
}Ergebnis herunterladen
video_url sieht aus wie https://api.tokenlab.sh/v1/media-results/{id}.mp4?token=…. Das Token in der URL ist das Anmeldeobjekt, daher ist kein Authorization-Header erforderlich. Geben Sie die URL nur an Personen weiter, die das Video sehen dürfen. Die URL leitet auf die Datei weiter, folgen Sie daher beim Herunterladen den Weiterleitungen (curl -L).
- Sie bleibt 30 Tage ab dem Zeitpunkt gültig, an dem das Ergebnis erstmals aufgezeichnet wurde. Laden Sie die Datei herunter, wenn Sie sie länger benötigen; siehe Datenaufbewahrung.
404 media_not_found: Das Token oder die Dateiendung stimmt nicht mit dem Ergebnis überein. Verwenden Sie die exakte URL, die Sie erhalten haben.410 media_expired: Der 30-Tage-Zeitraum ist abgelaufen.502oder503 media_unavailable: Das Ergebnis wird noch aufgezeichnet oder TokenLab ist ausgelastet. Wiederholen Sie den Vorgang nach derRetry-After-Verzögerung.- Fügen Sie
metadata=truezur URL hinzu, um den Speicherstatus anstelle der Datei zu lesen.
Einige Ergebnisse werden als https://api.tokenlab.sh/v1/videos/generations/{id}/content bereitgestellt. Diese URL benötigt denselben Authorization: Bearer-Header, den Sie für das Polling verwenden, und nur der Workspace, dem die Aufgabe gehört, kann sie öffnen.
Prüfintervall
- Prüfen Sie alle 5–10 Sekunden.
- Erhöhen Sie das Intervall für lang laufende Aufgaben.
- Legen Sie eine maximale Wartezeit für Ihre Anwendung fest.
- Stoppen Sie, wenn der Status
failedist, und zeigen Sie den zurückgegebenenerroran.
import requests
import time
def wait_for_video(task_id, max_wait=600, interval=5):
"""Auf Video mit Timeout warten."""
start = time.time()
while time.time() - start < max_wait:
response = requests.get(
f"https://api.tokenlab.sh/v1/tasks/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"}
)
response.raise_for_status()
data = response.json()
if data["status"] == "completed":
return data["video_url"]
elif data["status"] == "failed":
raise Exception(data.get("error", "Video generation failed"))
time.sleep(interval)
raise TimeoutError("Video generation timed out")Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Pfadparameter
Die asynchrone Task-ID, die über id / task_id zurückgegeben oder in poll_url eingebettet wird
Antwort
application/json
application/json
application/json
application/json
application/json
application/json
application/json