POST
/
shorts
/
{projectId}
/
{shortId}
/
render
curl -X POST "https://api.realoficial.com.br/api/v1/shorts/PROJECT_ID/SHORT_ID/render" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"

{
  "message": "Renderização iniciada com sucesso, você pode acompanhar o progresso no menu \"Meus Vídeos\".",
  "data": {
    "render_id": "01k6ij90yqtsyrzjb0hveqy9ef",
    "status": "pending"
  }
}

​
Endpoint

POST https://api.realoficial.com.br/api/v1/shorts/{projectId}/{shortId}/render
Este endpoint requer autenticacao via Bearer Token.

​
Path Parameters

​
projectId
string
required
ID do projeto (ULID)
​
shortId
string
required
ID do short a ser renderizado (ULID)

​
Rate Limits

Limites de renderizacao por hora:
  • Usuarios gratuitos: 3 cortes/hora
  • Usuarios pagantes: 30 cortes/hora
Usuarios que nunca fizeram deposito terao marca d’agua nos videos.

​
Resposta de Sucesso

​
message
string
Mensagem de confirmacao
​
data
object
Dados da renderizacao iniciada
curl -X POST "https://api.realoficial.com.br/api/v1/shorts/PROJECT_ID/SHORT_ID/render" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"

{
  "message": "Renderização iniciada com sucesso, você pode acompanhar o progresso no menu \"Meus Vídeos\".",
  "data": {
    "render_id": "01k6ij90yqtsyrzjb0hveqy9ef",
    "status": "pending"
  }
}

​
Renderizacao em Lote

Para renderizar multiplos shorts de uma vez: 
POST https://api.realoficial.com.br/api/v1/renders/bulk

​
Body Parameters

​
short_ids
array
required
Array de IDs dos shorts a renderizar
curl -X POST "https://api.realoficial.com.br/api/v1/renders/bulk" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "short_ids": [
      "01k4ef56yqtsyrzjb0gveqy7cd",
      "01k4ef57yqtsyrzjb0gveqy8de",
      "01k4ef58yqtsyrzjb0gveqy9fg"
    ]
  }'

{
  "message": "Acompanhe na tela de meus vídeos :)"
}
Requisitos para renderizacao em lote:
  • Usuario deve ter feito pelo menos um deposito real
  • Limite de 30 renderizacoes por hora continua valido

​
Status da Renderizacao

StatusDescricao
pendingNa fila de processamento
processingSendo renderizado
doneConcluido - video disponivel
errorErro durante renderizacao

​
Tempo de Processamento

O tempo medio de renderizacao e de 30 segundos a 2 minutos por corte, dependendo da duracao e complexidade.

​
Polling de Status

Apos iniciar a renderizacao, consulte o endpoint GET /renders para verificar quando o video esta pronto: 
async function waitForRender(renderId, maxAttempts = 30) {
  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch('https://api.realoficial.com.br/api/v1/renders', {
      headers: { 'Authorization': 'Bearer seu_token' }
    });

    const data = await response.json();
    const render = data.data.data.find(r => r.id === renderId);

    if (render?.status === 'done') {
      return render.download_url;
    }

    await new Promise(resolve => setTimeout(resolve, 5000)); // 5 segundos
  }

  throw new Error('Timeout aguardando renderizacao');
}