Sources

Get a source's processing status

Returns whether a source from POST /v1/sources is ready to use, however it was placed (clip, b-roll, overlay, background, background music or sound effect). Poll it after placing a newly uploaded source: while it is processing, frames and previews of videos that use it answer not-ready instead of rendering.

get/v1/sources/{sourceId}

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/sources/{sourceId}
  • Auth: HTTP bearer

Path parameters

sourceIdstring required

Source ID

Example:su_abc

Response

OK

idstring required

Source ID

status'pending' | 'processing' | 'ready' | 'failed' required

pending: the upload hasn't finished yet. Video and audio start converting as soon as it does, and images are prepared for rendering within a few seconds; LUTs and fonts are ready right away. processing: still uploading or converting; frames and previews of videos using it answer not-ready until it is ready, so poll this every few seconds. ready: usable everywhere. failed: conversion failed or the recording was cancelled; upload the file again as a new source.

Example response

{
  "id": "su_abc",
  "status": "processing"
}

Changes

No recorded changes to this operation across all 1 revision of this API.