Pular para o conteúdo
Entrar Lista de espera

Ver mídia

GET /v1/media/:id escopo read

Uma mídia (com publicUrl quando estiver pronta; vídeos trazem também durationMs, width e height quando o cabeçalho do arquivo diz; imagens trazem width e height).

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/midia/:id.

Parâmetros

Nome Onde Descrição
id caminho Id da mídia.

Exemplo

curl "https://praeko.app/v1/media/01KA3VQ7M2T9XE4HB8N5RZ6C0D" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "id": "01KA3VQ7M2T9XE4HB8N5RZ6C0D",
  "type": "video",
  "name": "video.mp4",
  "mime": "video/mp4",
  "size": 18874368,
  "state": "ready",
  "createdAt": "2026-11-07T14:02:11.482Z",
  "publicUrl": "https://praeko.app/v1/m/01KA3VQ7M2T9XE4HB8N5RZ6C0D/k7Qm2vXz9Rt4Lp8Wc3Nd6Hy1Bs5Fa0J/video.mp4",
  "durationMs": 58240,
  "width": 1080,
  "height": 1920
}

Enquanto state é uploading, a resposta traz parts ([{ n, size }], as partes já recebidas). Quando está ready, vem publicUrl; vídeos também trazem durationMs, width e height quando o contêiner informa.

Erros

Status code Quando
404 media_not_found A mídia não existe.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.