InícioReferência da API
Referencia apiClip

Clipes Preset Novo

POST
/v1/clip/presets

POST /v1/clip/presets. Contrato do handler clipesPresetNovo. 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.

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
layout?array<>
maxClips?integer
Intervalo2 <= value <= 40
maxLen?integer
Intervalo1 <= value
minClips?integer
Intervalo2 <= value
minLen?integer
Intervalo1 <= value
name*string
Comprimento1 <= length <= 300
prompt?string
Comprimento0 <= length <= 1000
subtitles?boolean
vinhetaFim?
vinhetaInicio?
watermarks?array<>

Corpo da resposta

Operação concluída.

application/json
  1. response
accountId?string
createdAt?string
Formatodate-time
name?string
slug?string
updatedAt?string
Formatodate-time
curl -X POST "https://example.com/v1/clip/presets" \  -H "Content-Type: application/json" \  -d '{    "captionBlur": 0,    "captionEffect": "scale",    "captionFont": "",    "captionHighlight": "",    "captionLines": 0,    "captionMargin": 0,    "captionPrimary": "",    "captionShadowX": 0,    "captionShadowY": 0,    "captionSize": 0,    "captionStroke": 0,    "captionUppercase": false,    "directoryId": "0123456789abcdefghijklmnopq",    "focus": false,    "format": "9:16",    "framing": "tight",    "headline": false,    "headlineBgColor": "",    "headlineDuration": 1,    "headlineEffect": "nenhum",    "headlineEffectDuration": 0,    "headlineFont": "",    "headlineMarginH": -1,    "headlineMarginV": 0,    "headlinePaddingH": 0,    "headlinePaddingV": 0,    "headlineRadius": 0,    "headlineSize": 0,    "headlineTextColor": "",    "headlineUppercase": false,    "headlineWidthPct": 1,    "maxClips": 2,    "maxLen": 1,    "minClips": 2,    "minLen": 1,    "name": "Exemplo sintético",    "prompt": "",    "subtitles": false,    "vinhetaFim": {      "duracao": 1,      "encaixe": "letterbox",      "fonte": "exemplo",      "transicao": ""    },    "vinhetaInicio": {      "duracao": 1,      "encaixe": "letterbox",      "fonte": "exemplo",      "transicao": ""    }  }'
{  "accountId": "018f0000-0000-7000-8000-000000000001",  "createdAt": "2026-01-15T12:00:00Z",  "name": "Exemplo sintético",  "slug": "",  "updatedAt": "2026-01-15T12:00:00Z"}

Clipes Presets Listar GET

GET /v1/clip/presets. Contrato do handler clipesPresetsListar. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.

Clipes Processa Upload Vinheta POST

POST /v1/clip/presets/upload-intro. Contrato do handler clipesProcessaUploadVinheta. Requer autenticação e autorização no contexto da conta; permissões e suspensão podem impedir a operação.