Enviar imagens de vídeo (individual ou múltiplas)
POST /v1/videos/{key}/{tipo-de-banner}. Consolida duas rotas reais: thumbnails ou end-screens seleciona videosProcessaUploadMultiplosBanners (regex prioritária); thumbnail, end-screen ou robot seleciona videosProcessaUploadBanner. Requer autenticação e autorização da conta. Envie multipart/form-data: nos tipos singulares, exatamente um arquivo no campo file; nos tipos plurais, um ou mais arquivos no campo file repetido. Para plural, ativo é índice baseado em 1 do arquivo que será selecionado; se ausente ou inválido, nenhum dos novos arquivos é marcado ativo. Os exemplos binários são PNG sintético válido em Base64; decodifique antes de montar o multipart. Outros tipos retornam 400.
bearerAuthAutorizaçãoBearer <token>JWT de usuário/console ou API token, conforme a autorização e as permissões da conta. Não enviar tokens reais nos exemplos.
key*stringIdentificador utilizado pelo handler.
mostrar_webhook_logs?stringuid?stringmultipart/form-data- body
Forma singular ou plural, determinada por tipo-de-banner no caminho. file é obrigatório em ambas.
file*unknownArquivo enviado como bytes no multipart. O exemplo JSON usa Base64 de um arquivo image/png sintético; decodifique antes de montar o multipart.
Operação concluída.
application/json- response
ads?allowPublicAccess?booleanassets?audioOnly?booleanautoCreateSubtitle?booleanbytesStorage?stringcreatedAt?stringdate-timedescription?stringdirectoryId?stringdubbing?booleandubbingLanguages?array<string>duration?numberextrasAdmin?files?array<>gaTag?stringgeoAccessControl?stringgeoBlacklist?array<string>geoWhitelist?array<string>googleDAI?id?stringipWhitelist?array<string>lastPlaybackAt?stringdate-timeloop?booleanoutputQualities?array<string>playerColor?stringplayerCustomization?published?booleanpublishedAt?stringdate-timerawSettings?referrerWhitelist?array<string>robotCustomization?rybena?booleansource?status?stringsubtitles?booleansubtitlesLanguages?array<string>summaries?summary?booleantags?array<string>thumbs?array<>title?stringtranscodeProgress?integerupdatedAt?stringdate-timevertical?booleanvideoId?stringvideoOnly?booleanvideo_360?booleanviews?integerwebhookLogs?array<>curl -X POST "https://example.com/v1/videos/0123456789abcdefghijklmnopq/thumbnail" \ -F file="iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+jX2kAAAAASUVORK5CYII="{ "ads": { "googleIMA": [], "vast": [], "vmap": [] }, "assets": { "endScreen": "", "highlights": false, "hls": "https://media.example.com/exemplo", "iframe": "https://media.example.com/exemplo", "mp4": {}, "player": "https://media.example.com/exemplo", "srt": "https://media.example.com/exemplo", "thumbPreview25": "", "thumbPreview50": "", "thumbPreview75": "", "thumbnail": "https://media.example.com/exemplo", "vtt": "https://media.example.com/exemplo" }, "audioOnly": false, "autoCreateSubtitle": false, "createdAt": "2026-01-15T12:00:00Z", "description": "Exemplo sintético para documentação.", "directoryId": "0123456789abcdefghijklmnopq", "dubbing": false, "dubbingLanguages": [], "duration": 0, "extrasAdmin": { "status_interno": "", "storage": "" }, "files": [], "geoAccessControl": "", "geoBlacklist": [], "geoWhitelist": [], "googleDAI": { "apiKey": "0123456789abcdefghijklmnopq", "assetKey": "0123456789abcdefghijklmnopq", "contentSourceId": "https://media.example.com/exemplo", "enabled": false, "type": "", "videoId": "0123456789abcdefghijklmnopq" }, "id": "0123456789abcdef01234567", "ipWhitelist": [], "lastPlaybackAt": "2026-01-15T12:00:00Z", "loop": false, "outputQualities": [], "playerColor": "", "playerCustomization": { "backgroundColor": "", "colorTone": "", "iconTextColor": "", "playButtonLocation": false, "primaryColor": "", "showConfigurations": false, "showFullscreen": false, "showLike": false, "showSeekControls": false, "showSound": false, "showSpeed": false, "showStatistics": false, "showTitle": false }, "published": false, "publishedAt": "2026-01-15T12:00:00Z", "rawSettings": { "playerCustomization": { "backgroundColor": "", "colorTone": "", "iconTextColor": "", "playButtonLocation": false, "primaryColor": "", "showConfigurations": false, "showFullscreen": false, "showLike": false, "showSeekControls": false, "showSound": false, "showSpeed": false, "showStatistics": false, "showTitle": false }, "robotCustomization": { "assistantAction": [], "decreaseVolumeActions": [], "enableVolumeActions": [], "increaseVolumeActions": [], "interruptAssistantActions": [], "interruptionActions": [], "momentSearchActions": [], "muteVolumeActions": [], "playbackActions": [], "selectedImage": "https://media.example.com/exemplo", "videoAdvanceActions": [], "videoRewindActions": [], "voiceAssistant": false, "welcomePhrase": "" }, "streaming": { "geoAccessControl": "", "geoRegionList": [], "ipWhitelist": [], "referrerWhitelist": [], "streamingProfile": "" }, "vod": { "ads": { "googleIMA": [], "vast": [], "vmap": [] }, "autoCreateSubtitle": false, "endScreen": "", "gaTag": "", "playerColor": "", "preRoll": { "destinationUrl": "", "enabled": false, "skipAfterSeconds": 0, "skippable": false, "source": "https://media.example.com/exemplo" }, "subtitleConfigs": false, "subtitleToggle": false, "thumbnail": "https://media.example.com/exemplo" } }, "referrerWhitelist": [], "robotCustomization": { "assistantAction": [], "decreaseVolumeActions": [], "enableVolumeActions": [], "increaseVolumeActions": [], "interruptAssistantActions": [], "interruptionActions": [], "momentSearchActions": [], "muteVolumeActions": [], "playbackActions": [], "selectedImage": "https://media.example.com/exemplo", "videoAdvanceActions": [], "videoRewindActions": [], "voiceAssistant": false, "welcomePhrase": "" }, "rybena": false, "source": { "clipe": { "duration_ms": 0, "end_ms": 0, "engagement_score": 0, "files": {}, "hashtags": [], "hook_score": 0, "hook_text": "", "ideal_format": "", "index": 0, "layout": "", "nano_hook_text": "", "reason": "", "retention_score": 0, "start_ms": 0, "title": "Exemplo sintético", "viral_score": 0 }, "duration": 0, "file": "", "id": "0123456789abcdef01234567", "live2vod": "", "opusclipJobId": "0123456789abcdef01234567", "opusclipParentVideoId": "0123456789abcdefghijklmnopq", "opusclipProjectId": "0123456789abcdef01234567", "resolution": "", "service": "", "size": 0, "url": "https://media.example.com/exemplo" }, "status": "Publicado", "subtitles": false, "subtitlesLanguages": [], "summary": false, "tags": [], "thumbs": [], "title": "Exemplo sintético", "transcodeProgress": 0, "updatedAt": "2026-01-15T12:00:00Z", "vertical": false, "videoId": "0123456789abcdefghijklmnopq", "videoOnly": false, "video_360": false, "views": 0, "webhookLogs": []}Videos Progresso Transcode GET
GET /v1/videos/{key}/transcode/progress. Contrato do handler videosProgressoTranscode. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.
Atualizar Thumbnails Default PATCH
PATCH /v1/videos/{key}/{tipo-de-banner}. Rota original registrada como /v1/videos/{tipo-de-banner}/{diretorio_id}; os parâmetros foram renomeados somente no contrato OpenAPI para consolidar caminhos com a mesma forma. Nesta operação PATCH, key representa o PRIMEIRO segmento original tipo-de-banner (tipo da imagem), e tipo-de-banner representa o SEGUNDO segmento original diretorio_id (ID de diretório alfanumérico de 27 caracteres), não uma chave de vídeo. Contrato do handler atualizarThumbnailsDefault. Requer autenticação e autorização da conta.