Conceitos

Objetos centrais

• Organização — o “tenant” dono dos vídeos, das API keys e do uso. Cada usuário tem uma organização (provisionada no primeiro login).
• Asset / Vídeo (vid_...) — o vídeo em si, identificador estável por toda a sua vida (CRUD).
• Upload (up_...) — uma sessão de envio do arquivo fonte.
• Playback ID (play_...) — controla a visibilidade das URLs de playback.

Ciclo de vida do vídeo

Após o ingest, o transcode roda em background. O campo status reflete o estágio:

status	Significado
preparing	upload/transcode em andamento (veja progress, 0–100)
ready	pronto — playback.hls/dash/mp4 preenchidos
reprocessing	nova tentativa transitória de encode
errored	falhou — veja errors[]

Pipeline de ingest & transcode

ingest (URL ou upload) → fonte no storage → transcode (HEVC + AVC)
  → empacotamento CMAF (HLS + DASH) + MP4 progressivo por resolução
  → URLs públicas em stream.devstreamcore.com

As URLs apontam direto para o storage público — players consomem sem hops intermediários.

Roadmap (ainda não disponível)

• Playback privado / signed — a API aceita playback_policy: "signed", mas a URL gerada continua pública (sem assinatura de token). Trate todo vídeo como público; se precisar restringir, controle a autorização no seu backend.
• Player embeddável e analytics avançado (watch time, dispositivo, geografia) — hoje só há view_count por vídeo.