Video & Materialien

Aufgaben auflisten (Volc-kompatibel)

Listet aktuelle Seedance-Kompatibilitätsaufgaben für die aktuelle Organisation auf.

GET
/api/v3/contents/generations/tasks

Übersicht

Listet Kompatibilitätsaufgaben der authentifizierten Organisation unter Verwendung eines TokenLab Bearer API-Keys auf. Es werden nur Aufgaben aufgelistet, die über den Volc-kompatiblen Erstellungs-Endpunkt erstellt wurden. Ohne filter.task_ids decken die Ergebnisse Aufgaben der letzten sieben Tage ab; die Angabe exakter IDs fragt diese Aufgaben direkt ab.

Siehe auch Seedance 2.0 Videomodelle und Videogenerierung.

Auflistung und Filter

  • page_num: Standard 1, Ganzzahl von 1 bis 500.
  • page_size: Standard 20, Ganzzahl von 1 bis 500.
  • filter.status: queued, running, succeeded, failed, cancelled, expired.
  • filter.task_ids: Wiederholen Sie diesen Parameter für mehrere exakte Task-IDs; verbinden Sie diese nicht mit Kommas.
  • filter.model: Der model-Wert, der bei der Erstellung der Aufgabe gesendet wurde.
  • filter.service_tier: default, flex.

Die Antwort enthält items (die angeforderte Seite) und total (alle Aufgaben, die den Filtern entsprechen). Jedes Element verwendet das Antwortformat für das Abrufen von Aufgaben (get-task). Ein nicht unterstützter Parameter oder ein Wert außerhalb des zulässigen Bereichs führt zu einem 400-Fehler. Verwenden Sie den get-Endpunkt, um den Status einer bekannten Aufgabe zu aktualisieren.

Beispiel

curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?filter.task_ids=cgt-20260102030405-a1b2c" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl -X GET "https://example.com/api/v3/contents/generations/tasks"
{  "items": [    {      "id": "string",      "model": "string",      "status": "queued",      "content": {        "video_url": "http://example.com",        "last_frame_url": "http://example.com"      },      "seed": 0,      "resolution": "string",      "ratio": "string",      "duration": "string",      "frames": 0,      "framespersecond": 0,      "generate_audio": true,      "tools": {        "type": "web_search"      },      "safety_identifier": "string",      "draft": true,      "draft_task_id": "string",      "service_tier": "string",      "execution_expires_after": 0,      "usage": {        "completion_tokens": 0,        "total_tokens": 0,        "tool_usage": {          "web_search": 0        }      },      "error": {        "code": "string",        "message": "string"      },      "created_at": 0,      "updated_at": 0    }  ],  "total": 0}

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Abfrageparameter

page_num?integer

Seitennummer.

Bereich1 <= value <= 500
Standard1
page_size?integer

Seitengröße.

Bereich1 <= value <= 500
Standard20
filter.status?string

Nach Aufgabenstatus filtern.

Zulässige Werte

  • "queued"
  • "running"
  • "succeeded"
  • "failed"
  • "cancelled"
  • "expired"
filter.task_ids?array<string>

Exakte Aufgaben-IDs. Wiederholen Sie filter.task_ids für mehrere IDs.

filter.model?string

Filtern nach dem Modellwert, der bei der Erstellung der Aufgabe gesendet wurde.

filter.service_tier?string

Nach Service-Stufe filtern.

Zulässige Werte

  • "default"
  • "flex"

Antwort

application/json

application/json

application/json

application/json