Referencia apiVideos
Videos Novo
POST
POST /v1/videos. Contrato do handler videosNovo. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.
bearerAuthheader
Autorizaçã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.
mostrar_webhook_logs?stringuid?stringapplication/json- body
accountId?stringads?aes?booleanallowPublicAccess?booleanaudioOnly?booleanautoCreateSubtitle?booleandescription?stringComprimento
length <= 300directoryId?stringgaTag?stringgeoAccessControl?stringgeoBlacklist?array<string>geoWhitelist?array<string>googleDAI?ipWhitelist?array<string>metadata?array<>outputFormats?array<string>outputQualities?array<string>playerColor?stringplayerCustomization?preRoll?referrerWhitelist?array<string>robotCustomization?rybena?booleansource?stringtags?array<string>title*stringComprimento
1 <= length <= 300videoOnly?booleanOperação concluída.
application/json- response
ads?allowPublicAccess?booleanassets?audioOnly?booleanautoCreateSubtitle?booleanbytesStorage?stringcreatedAt?stringFormato
date-timedescription?stringdirectoryId?stringdubbing?booleandubbingLanguages?array<string>duration?numberextrasAdmin?files?array<>gaTag?stringgeoAccessControl?stringgeoBlacklist?array<string>geoWhitelist?array<string>googleDAI?id?stringipWhitelist?array<string>lastPlaybackAt?stringFormato
date-timeloop?booleanoutputQualities?array<string>playerColor?stringplayerCustomization?published?booleanpublishedAt?stringFormato
date-timerawSettings?referrerWhitelist?array<string>robotCustomization?rybena?booleansource?status?stringsubtitles?booleansubtitlesLanguages?array<string>summaries?summary?booleantags?array<string>thumbs?array<>title?stringtranscodeProgress?integerupdatedAt?stringFormato
date-timevertical?booleanvideoId?stringvideoOnly?booleanvideo_360?booleanviews?integerwebhookLogs?array<>curl -X POST "https://example.com/v1/videos" \ -H "Content-Type: application/json" \ -d '{ "accountId": "018f0000-0000-7000-8000-000000000001", "ads": { "googleIMA": [], "vast": [], "vmap": [] }, "aes": false, "allowPublicAccess": false, "audioOnly": false, "autoCreateSubtitle": false, "description": "Exemplo sintético para documentação.", "directoryId": "0123456789abcdefghijklmnopq", "gaTag": "", "geoAccessControl": "", "geoBlacklist": [], "geoWhitelist": [], "googleDAI": { "apiKey": "0123456789abcdefghijklmnopq", "assetKey": "0123456789abcdefghijklmnopq", "contentSourceId": "https://media.example.com/exemplo", "enabled": false, "type": "", "videoId": "0123456789abcdefghijklmnopq" }, "ipWhitelist": [], "metadata": [], "outputFormats": [], "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 }, "preRoll": { "destinationUrl": "", "enabled": false, "skipAfterSeconds": 0, "skippable": false, "source": "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": "https://media.example.com/exemplo", "tags": [], "title": "Exemplo sintético", "videoOnly": false }'{ "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 Listar GET
GET /v1/videos. Contrato do handler videosListar. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.
Clipes Lista Parametros GET
GET /v1/videos/clip/parameters. Contrato do handler clipesListaParametros. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.