Poll a prediction
Returns the prediction’s current state. Poll every 3-5 seconds until a terminal status (success, error, cancelled).
Authorizations
Your eachlabs API key (dashboard → API keys), sent as Authorization: Bearer <api_key> on every request. One key authenticates and bills every video operation.
Path Parameters
The prediction id returned by submit as predictionID.
Response
Current prediction state.
Body of GET /v1/prediction/{id} — the poll envelope.
Your submitted input, echoed back as sent — a tolerated legacy submission that omitted capability or params echoes without those fields.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
- Option 19
- Option 20
- Option 21
- Option 22
- Option 23
- Option 24
- Option 25
- Option 26
- Option 27
- Option 28
- Option 29
- Option 30
- Option 31
- Option 32
- Option 33
- Option 34
- Option 35
- Option 36
- Option 37
- Option 38
- Option 39
- Option 40
- Option 41
- Option 42
- Option 43
- Option 44
- Option 45
- Option 46
Present on every poll; null today.
Value of the poll envelope's output field. Capability descriptions that mention an output_urls array refer to THIS field — through the gateway the artifact URL array IS the output value. The shape follows the capability's output class: media capabilities deliver hosted artifact URL(s) as an array (single-artifact capabilities deliver a one-element array); analysis capabilities (probe, scene_detect, silence_detect, audio_analysis) deliver structured JSON (an object, which may also arrive as a JSON string or as a URL to a JSON body); packaging capabilities (package_abr, package_abr_ladder, hls_ladder) deliver the manifest plus artifacts. On status "error" this is the ErrorOutput object. Download or persist artifact URLs promptly; treat them as valid for at least 24 hours.
Typical flow: starting → processing → success. Terminal states: success, error, cancelled. The video surface writes "starting" as the initial state; "created" appears only on legacy paths, so a poll loop may never observe it. A failed prediction reports "error", never "failed". Poll every 3-5 seconds — platform status checks are quantized to ~5 s, tighter loops buy nothing. No queue-time bound is enforced: a prediction can wait in "starting" behind the per-tier concurrency cap; keep polling.
created, starting, processing, success, error, cancelled