Get Video Status

GET/v1/videos/{request_id}

Overview

Requires the originating API key and requests.read. Status may advance a due native poll. It never starts another generation. Background recovery continues after disconnect or restart, including when new video generation is disabled.

Authorization

Authorizationstring · headerRequired

AudioLab API key sent as Bearer <token>. Authentication guide

Parameters

request_idpath · stringRequired

Responses

200Current state, progress, settled customer cost and authenticated content path.

401Invalid API key.

403Missing requests.read scope.

404Video request not found for this key.

Replace uppercase placeholders before running. JavaScript examples require Node.js 22 or later; Python examples require requests. WebSocket examples require the Node.js ws package. See setup for credentials.

curl --fail --show-error --request GET \
  --url "$AUDIOLAB_API_URL/v1/videos/YOUR_REQUEST_ID" \
  --header "Authorization: Bearer $AUDIOLAB_API_KEY"

HTTP/1.1 200

Current state, progress, settled customer cost and authenticated content path.

Example responses · See schemas for all fields