Videogenerierungs-Status abrufen

Pollt einen Video-Job. Die einzigen Endzustände sind completed / failed; währenddessen sehen Sie meist pending / processing, aber Upstream-Zwischenlabels (z. B. in_progress) können durchgereicht werden — schreiben Sie Ihre Schleife als "bis completed oder failed" statt Zwischenzustände aufzuzählen. Upstream-Abbrüche/-Abläufe (cancelled / expired) erscheinen als failed, das reservierte Guthaben wurde erstattet. Bei completed listet unsigned_urls die herunterladbaren Inhaltspfade und usage.cost ist der endgültige Betrag (nach tatsächlich gelieferten Sekunden); bei failed erklärt error den Grund. Upstream-Prüfungen sind serverseitig auf eine pro 8 s gedrosselt; pollen Sie im Abstand von ≥5 s.

GET/api/v1/videos/:id

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Pfadparameter

iderforderlich

string

Die beim Senden zurückgegebene Job-ID (Präfix vjob_). Nur Jobs desselben Kontos sind sichtbar.

Example: "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"

Detailguide →

GET /api/v1/videos/:id

1
2
curl https://bazaarlink.ai/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

Antwortbeispiele

Erfolg. Das Beispiel zeigt einen completed-Job; pending / processing lassen unsigned_urls und usage weg, failed fügt ein error-Feld hinzu. unsigned_urls sind relative Pfade — mit demselben API-Schlüssel per GET herunterladen.

1
2
3
4
5
6
7
8
9
10
11
12
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "completed",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "unsigned_urls": [
    "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk/content?index=0"
  ],
  "usage": {
    "cost": 0.5,
    "is_byok": false
  }
}