InícioReferência da API
Referencia apiVideos

Opus Clip Criar Job

POST
/v1/videos/{key}/opusclip/jobs

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

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.

Corpo da requisição

application/json
  1. body
aspectRatio?string
autoSubtitles?boolean
durationRange?array<integer>
emojis?boolean
prompt?string
range?
useRange?boolean

Corpo da resposta

Operação concluída.

application/json
  1. response
accountId?string
attempts?integer
availableClips?array<>
billingDurationSeconds?number
clips?array<>
clipsCount?integer
clipsVideoIds?array<string>
createdAt?string
Formatodate-time
error?string
estimatedCredits?integer
finishedAt?string
Formatodate-time
id?string
Corresponde a^[0-9a-f]{24}$
jobId?string
opusCollectionId?string
opusPayloads?
opusProjectId?string
request?
selectedClipIds?array<string>
sourceUrl?string
sourceVideoId?string
stage?string
status?string
updatedAt?string
Formatodate-time
userId?string
webhookUrl?string
curl -X POST "https://example.com/v1/videos/0123456789abcdefghijklmnopq/opusclip/jobs" \  -H "Content-Type: application/json" \  -d '{    "aspectRatio": "",    "autoSubtitles": false,    "emojis": false,    "prompt": "",    "range": {      "endSec": 0,      "startSec": 0    },    "useRange": false  }'
{  "accountId": "018f0000-0000-7000-8000-000000000001",  "attempts": 0,  "availableClips": [],  "billingDurationSeconds": 0,  "clips": [],  "clipsCount": 0,  "clipsVideoIds": [],  "createdAt": "2026-01-15T12:00:00Z",  "error": "",  "estimatedCredits": 0,  "finishedAt": "2026-01-15T12:00:00Z",  "id": "0123456789abcdef01234567",  "jobId": "0123456789abcdef01234567",  "opusCollectionId": "0123456789abcdef01234567",  "opusPayloads": {},  "opusProjectId": "0123456789abcdef01234567",  "request": {    "aspectRatio": "",    "autoSubtitles": false,    "emojis": false,    "prompt": "",    "range": {      "endSec": 0,      "startSec": 0    },    "useRange": false  },  "selectedClipIds": [],  "sourceUrl": "https://media.example.com/exemplo",  "sourceVideoId": "https://media.example.com/exemplo",  "stage": "",  "status": "",  "updatedAt": "2026-01-15T12:00:00Z",  "userId": "0123456789abcdef01234567",  "webhookUrl": ""}

Opus Clip Listar Jobs Video GET

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

Receita atual do VOD GET

Retorna a ultima receita concluida ou um esqueleto com a propria fonte. latestVersion inclui edicoes ainda nao concluidas; editVersion e a versao de cache-bust. As URLs de preview sao assinadas; sourceMp4 pode ser vazio quando nao ha renditions MP4.