InícioReferência da API
Referencia apiVideos

Clipes Novo Job

PUT
/v1/videos/{key}/clip/job

PUT /v1/videos/{key}/clip/job. Contrato do handler clipesNovoJob. 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.

Parâmetros de query

preset?string

Corpo da requisição

application/json
  1. body
captionBlur?number
Intervalo0 <= value
captionEffect?string
Valor em"scale""bounce""caixa""nenhum"
captionFont?string
captionHighlight?string
captionLines?integer
Intervalo0 <= value
captionMargin?integer
Intervalo0 <= value
captionPrimary?string
captionShadowX?integer
captionShadowY?integer
captionSize?integer
Intervalo0 <= value
captionStroke?number
Intervalo0 <= value
captionUppercase?boolean
directoryId?string
focus?boolean
format?string
Valor em"9:16""1:1""4:5""16:9""tiktok""reels""instagram"
framing?string
Valor em"tight""sharp"
headline?boolean
headlineBgColor?string
headlineDuration?number
Intervalo0 < value
headlineEffect?string
Valor em"nenhum""dissolve""direita""esquerda"
headlineEffectDuration?number
Intervalo0 <= value <= 2
headlineFont?string
headlineMarginH?integer
Intervalo-1 <= value
headlineMarginV?integer
Intervalo0 <= value
headlinePaddingH?integer
Intervalo0 <= value
headlinePaddingV?integer
Intervalo0 <= value
headlineRadius?integer
Intervalo0 <= value
headlineSize?integer
Intervalo0 <= value
headlineTextColor?string
headlineUppercase?boolean
headlineWidthPct?integer
Intervalo1 <= value <= 100
identificacao?string
layout?array<>
maxClips?integer
Intervalo2 <= value <= 40
maxLen?integer
Intervalo1 <= value
minClips?integer
Intervalo2 <= value
minLen?integer
Intervalo1 <= value
prompt?string
Comprimento0 <= length <= 1000
subtitles?boolean
vinhetaFim?
vinhetaInicio?
watermarks?array<>

Corpo da resposta

Operação concluída.

application/json
  1. response
identificacao?string
jobId?string
status?string
videoId?string
curl -X PUT "https://example.com/v1/videos/0123456789abcdefghijklmnopq/clip/job" \  -H "Content-Type: application/json" \  -d '{    "format": "9:16",    "maxClips": 4,    "maxLen": 60,    "minClips": 2,    "minLen": 15,    "prompt": "Gerar cortes sintéticos para demonstração."  }'
{  "identificacao": "",  "jobId": "0123456789abcdef01234567",  "status": "",  "videoId": "0123456789abcdefghijklmnopq"}

Listar Jobs Clipe POST

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

Videos Status Job Clipe GET

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