Video & Materialien

Video-Status abrufen

Status und Ergebnis einer Video-Aufgabe abrufen

GET
/v1/tasks/{id}

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

idstringpatherforderlich

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.

idstring

Task-ID.

task_idstring

Dieselbe Task-ID wie id.

poll_urlstring

Status-URL für diese Aufgabe. Fragen Sie GET /v1/tasks/{id} mit der id ab.

billing_transaction_idstring

Abrechnungs-Transaktions-ID nach Abschluss. Diese ist von der Task-ID getrennt.

statusstring

Task-Status: pending, processing, completed, failed.

progressinteger

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.

video_urlstring

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.

last_frame_urlstring

URL des zuletzt generierten Frames, wenn Sie dies mit return_last_frame angefordert haben und das Modell dies unterstützt.

videoobject

Einzelnes Videoergebnis mit url, duration, width und height, sofern verfügbar.

videosarray

Mehrere Videoergebnisse, wenn die Aufgabe mehr als eine Ausgabe zurückgibt.

errorstring | object

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.

media_retentionobject

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.

createdinteger

Zeitstempel der Erstellung.

updatedinteger

Zeitstempel der letzten Aktualisierung.

modelstring

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.
  • 502 oder 503 media_unavailable: Das Ergebnis wird noch aufgezeichnet oder TokenLab ist ausgelastet. Wiederholen Sie den Vorgang nach der Retry-After-Verzögerung.
  • Fügen Sie metadata=true zur 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 failed ist, und zeigen Sie den zurückgegebenen error an.
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
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

id*string

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