POST
/
createShorts
curl -X POST "https://api.realoficial.com.br/api/v1/createShorts" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "clipDuration": "60",
    "startTime": 0,
    "endTime": 1800,
    "aspect_ratio": "vertical",
    "layout": "single"
  }'

{
  "data": {
    "id": "01k3ab12yqtsyrzjb0fveqy5zx",
    "title": "Titulo do Video",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "status": "pending",
    "goal": "shorts",
    "video_layout": "single",
    "aspect_ratio": "vertical",
    "clip_duration": "60",
    "start_time": 0,
    "end_time": 1800,
    "created_at": "2025-01-24T10:30:00.000000Z",
    "thumbnail_url": "https://img.youtube.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "metadata": {
      "title": "Titulo do Video",
      "duration": "45:30",
      "channel_title": "Canal do Autor"
    }
  }
}

​
Endpoint

POST https://api.realoficial.com.br/api/v1/createShorts
Este endpoint requer autenticacao e consome creditos do usuario.

​
Body Parameters

​
url
string
required
URL do video (YouTube, Google Drive ou link direto .mp4)
​
clipDuration
string
required
Duracao alvo dos cortes: 30, 60, 90, 120 ou auto
​
startTime
number
required
Tempo inicial do trecho a processar (em segundos)
​
endTime
number
required
Tempo final do trecho a processar (em segundos)
​
aspect_ratio
string
required
Formato do video: vertical (9:16) ou horizontal (16:9)
​
layout
string
Layout do video: auto, single, split, react, gaming
  • auto: Layout combinado entre single / split e center
  • single: Video unico com face tracking
  • split: Tela dividida (face + conteudo)
  • center: Vídeo centralizado na tela
  • react: Estilo reacao
  • gaming: Para gameplays
​
video_type
string
Tipo de processamento: shorts (padrao) ou reframe
​
title
string
Titulo personalizado do projeto (usa titulo do video se nao informado)
​
captionFont
string
Fonte padrao para legendas
​
captionTemplate
json
Template de estilo de legendas. Você pode obter o JSON do template em app.realoficial.com.br/docs/caption-templates
​
ignoreCaptions
boolean
default:"false"
Se true, gera os cortes sem legendas.
​
prompt
string
Prompt customizado para guiar a geracao dos cortes. Maximo de 1000 caracteres.
​
emojisEnabled
boolean
default:"false"
Se true, habilita emojis nas legendas.
​
show_in_content_hub
boolean
default:"true"
Se true, compartilha os cortes no hub de conteudo.
​
autoCta
boolean
default:"false"
Se true, adiciona uma chamada para acao (CTA) nos primeiros 3 segundos do corte.

​
Custo em Creditos

1 credito = 1 minuto de video processadoO custo e calculado automaticamente com base no intervalo endTime - startTime.

​
Validacoes

RegraLimite
Intervalo minimo10 minutos (600 segundos)
Intervalo maximo modo reframe5 minutos (300 segundos)
Duracao maxima do video10 horas
Videos > 5hIntervalo minimo de 1 hora
Videos > 3hRequer assinatura ativa
curl -X POST "https://api.realoficial.com.br/api/v1/createShorts" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "clipDuration": "60",
    "startTime": 0,
    "endTime": 1800,
    "aspect_ratio": "vertical",
    "layout": "single"
  }'

{
  "data": {
    "id": "01k3ab12yqtsyrzjb0fveqy5zx",
    "title": "Titulo do Video",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "status": "pending",
    "goal": "shorts",
    "video_layout": "single",
    "aspect_ratio": "vertical",
    "clip_duration": "60",
    "start_time": 0,
    "end_time": 1800,
    "created_at": "2025-01-24T10:30:00.000000Z",
    "thumbnail_url": "https://img.youtube.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "metadata": {
      "title": "Titulo do Video",
      "duration": "45:30",
      "channel_title": "Canal do Autor"
    }
  }
}

​
Status do Projeto

Apos criar o projeto, ele passara pelos seguintes status:
StatusDescricao
pendingAguardando processamento
downloadingBaixando o video
transcribingTranscrevendo audio
transcribedTranscricao concluida
shorts_createdCortes identificados
face_analysis_donePronto para uso
refundedReembolsado
Polling recomendado: Consulte GET /shorts/{projectId} a cada 10-30 segundos para verificar quando os cortes estao prontos.

​
Visualizar Cortes

Apos o projeto ser processado, voce pode visualizar os cortes gerados atraves de uma pagina de preview: 
https://app.realoficial.com.br/share/{projectId}?token={seu_token}
Pagina de preview dos cortes
​
projectId
string
required
ID do projeto retornado na criacao
​
token
string
required
Seu token de autenticacao (o mesmo usado nas requisicoes da API)

​
Exemplo de URL

https://app.realoficial.com.br/share/01k3ab12yqtsyrzjb0fveqy5zx?token=seu_token_aqui
Use essa URL para compartilhar a previa dos cortes com sua equipe ou integrar em sua aplicacao via iframe. Nenhuma menção ao real oficial é feita nela

​
URLs Suportadas

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • Videos com mais de 10 minutos de duracao
  • YouTube Shorts nao sao suportados
  • Links de compartilhamento publico
  • Maximo 10GB por arquivo