InícioReferência da API
Referencia apiVideos

Videos Processa Upload

POST
/v1/videos/{key}/source-alt

POST /v1/videos/{key}/source-alt. Contrato do handler videosProcessaUpload. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação. Upload de vídeo por multipart/form-data (campo file). Content-Range habilita upload em chunks; 202 pode indicar chunk aceito ou upload já finalizado. O token de upload é renovado durante o envio.

Autorização

bearerAuth
headerAutorizaçã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.

Parâmetros de path

key*string

Identificador utilizado pelo handler.

Parâmetros de query

directory?string
tags?string
mediaId?string
dailymotionId?string
sambaId?string
mostrar_webhook_logs?string
uid?string

Parâmetros de header

Content-Range?string

Corpo da requisição

multipart/form-data
  1. body
accountId?string
file*unknown

Arquivo enviado como bytes no multipart. O exemplo JSON usa Base64 de um arquivo video/mp4 sintético; decodifique antes de montar o multipart.

Corpo da resposta

Upload concluído retorna vídeo em JSON; chunk aceito ou upload já finalizado pode retornar 202 sem corpo.

application/json
  1. response
ads?
allowPublicAccess?boolean
assets?
audioOnly?boolean
autoCreateSubtitle?boolean
bytesStorage?string
createdAt?string
Formatodate-time
description?string
directoryId?string
dubbing?boolean
dubbingLanguages?array<string>
duration?number
extrasAdmin?
files?array<>
gaTag?string
geoAccessControl?string
geoBlacklist?array<string>
geoWhitelist?array<string>
googleDAI?
id?string
ipWhitelist?array<string>
lastPlaybackAt?string
Formatodate-time
loop?boolean
outputQualities?array<string>
playerColor?string
playerCustomization?
published?boolean
publishedAt?string
Formatodate-time
rawSettings?
referrerWhitelist?array<string>
robotCustomization?
rybena?boolean
source?
status?string
subtitles?boolean
subtitlesLanguages?array<string>
summaries?
summary?boolean
tags?array<string>
thumbs?array<>
title?string
transcodeProgress?integer
updatedAt?string
Formatodate-time
vertical?boolean
videoId?string
videoOnly?boolean
video_360?boolean
views?integer
webhookLogs?array<>
curl -X POST "https://example.com/v1/videos/0123456789abcdefghijklmnopq/source-alt" \  -H "Content-Range: bytes 0-1049/1050" \  -F accountId="018f0000-0000-7000-8000-000000000001" \  -F file="AAAAIGZ0eXBpc29tAAACAGlzb21pc282aXNvMm1wNDEAAAMrbW9vdgAAAGxtdmhkAAAAAAAAAAAAAAAAAAAD6AAAAAAAAQAAAQAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAi50cmFrAAAAXHRraGQAAAADAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAABAAAAAABAAAAAQAAAAAAHKbWRpYQAAACBtZGhkAAAAAAAAAAAAAAAAAABAAAAAAABVxAAAAAAALWhkbHIAAAAAAAAAAHZpZGUAAAAAAAAAAAAAAABWaWRlb0hhbmRsZXIAAAABdW1pbmYAAAAUdm1oZAAAAAEAAAAAAAAAAAAAACRkaW5mAAAAHGRyZWYAAAAAAAAAAQAAAAx1cmwgAAAAAQAAATVzdGJsAAAA6XN0c2QAAAAAAAAAAQAAANltcDR2AAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAABAAEABIAAAASAAAAAAAAAABEkxhdmM2My4xLjEwMSBtcGVnNAAAAAAAAAAAAAAAAAAAGP//AAAAX2VzZHMAAAAAA4CAgE4AAQAEgICAQCARAAAAAAMNQAADDUAFgICALgAAAbABAAABtYkTAAABAAAAASAAxI2IAA0AhAIUYwAAAbJMYXZjNjMuMS4xMDEGgICAAQIAAAAQcGFzcAAAAAEAAAABAAAAFGJ0cnQAAAAAAAMNQAADDUAAAAAQc3R0cwAAAAAAAAAAAAAAEHN0c2MAAAAAAAAAAAAAABRzdHN6AAAAAAAAAAAAAAAAAAAAEHN0Y28AAAAAAAAAAAAAAChtdmV4AAAAIHRyZXgAAAAAAAAAAQAAAAEAAAAAAAAAAAAAAAAAAABhdWR0YQAAAFltZXRhAAAAAAAAACFoZGxyAAAAAAAAAABtZGlyYXBwbAAAAAAAAAAAAAAAACxpbHN0AAAAJKl0b28AAAAcZGF0YQAAAAEAAAAATGF2ZjYzLjEuMTAxAAAAcG1vb2YAAAAQbWZoZAAAAAAAAAABAAAAWHRyYWYAAAAkdGZoZAAAADkAAAABAAAAAAAAA0sAAEAAAAAAFAEBAAAAAAAUdGZkdAEAAAAAAAAAAAAAAAAAABh0cnVuAAAABQAAAAEAAAB4AgAAAAAAABxtZGF0AAABswAQBwAAAbYWBRgqG2B4Ba8AAABDbWZyYQAAACt0ZnJhAQAAAAAAAAEAAAAAAAAAAQAAAAAAAAAAAAAAAAAAA0sBAQEAAAAQbWZybwAAAAAAAABD"
{  "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 Processa Upload POST

POST /v1/videos/{key}/source. Contrato do handler videosProcessaUpload. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação. Upload de vídeo por multipart/form-data (campo file). Content-Range habilita upload em chunks; 202 pode indicar chunk aceito ou upload já finalizado. O token de upload é renovado durante o envio.

Remover Legenda Do Video DELETE

DELETE /v1/videos/{key}/subtitle. Contrato do handler removerLegendaDoVideo. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.