GET
https://api.realoficial.com.br/api/v1
/
shorts
/
{projectId}
curl -X GET "https://api.realoficial.com.br/api/v1/shorts/01k3ab12yqtsyrzjb0fveqy5zx?limit=10&sort=score" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"

{
  "message": "Lista de shorts obtida com sucesso.",
  "project": {
    "id": "01k3ab12yqtsyrzjb0fveqy5zx",
    "title": "Podcast Episodio 42",
    "status": "face_analysis_done",
    "thumbnail_url": "https://img.youtube.com/vi/abc123/maxresdefault.jpg"
  },
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "01k4ef56yqtsyrzjb0gveqy7cd",
        "title": "Momento viral #1",
        "start_time": 245.5,
        "end_time": 305.2,
        "score": 92,
        "status": "face_analysis_done",
        "has_render": true,
        "feedback": "like",
        "created_at": "2025-01-24T10:35:00.000000Z",
        "renders": [
          {
            "id": "01k5gh78...",
            "status": "done",
            "created_at": "2025-01-24T11:00:00.000000Z"
          }
        ],
        "timeline": {
          "compositionWidth": 1080,
          "compositionHeight": 1920,
          "tracks": [...],
          "items": {...},
          "assets": {...}
        }
      },
      {
        "id": "01k4ef57yqtsyrzjb0gveqy8de",
        "title": "Momento viral #2",
        "start_time": 512.0,
        "end_time": 571.5,
        "score": 87,
        "status": "face_analysis_done",
        "has_render": false,
        "feedback": null,
        "created_at": "2025-01-24T10:35:00.000000Z",
        "renders": [],
        "timeline": {...}
      }
    ],
    "first_page_url": "...",
    "from": 1,
    "last_page": 3,
    "per_page": 10,
    "to": 10,
    "total": 24
  },
  "meta": {
    "average_score": 75.50,
    "average_duration": 58.30
  }
}

​
Endpoint

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

​
Path Parameters

​
projectId
string
required
ID do projeto (ULID)

​
Query Parameters

​
page
integer
Numero da pagina (padrao: 1)
​
limit
integer
Quantidade de itens por pagina (1-100, padrao: 20)
​
sort
string
Ordenacao dos resultados:
  • score (padrao) - Por pontuacao de relevancia
  • time - Por tempo de inicio no video
  • duration - Por duracao do corte
​
render
string
Filtrar por status de renderizacao:
  • all (padrao) - Todos os cortes
  • rendered - Apenas renderizados
  • not_rendered - Apenas nao renderizados
  • liked - Apenas marcados como favoritos

​
Resposta de Sucesso

​
message
string
Mensagem de confirmacao
​
project
object
Dados resumidos do projeto
​
data
object
Objeto paginado com os shorts
​
meta
object
Metadados agregados
curl -X GET "https://api.realoficial.com.br/api/v1/shorts/01k3ab12yqtsyrzjb0fveqy5zx?limit=10&sort=score" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"

{
  "message": "Lista de shorts obtida com sucesso.",
  "project": {
    "id": "01k3ab12yqtsyrzjb0fveqy5zx",
    "title": "Podcast Episodio 42",
    "status": "face_analysis_done",
    "thumbnail_url": "https://img.youtube.com/vi/abc123/maxresdefault.jpg"
  },
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "01k4ef56yqtsyrzjb0gveqy7cd",
        "title": "Momento viral #1",
        "start_time": 245.5,
        "end_time": 305.2,
        "score": 92,
        "status": "face_analysis_done",
        "has_render": true,
        "feedback": "like",
        "created_at": "2025-01-24T10:35:00.000000Z",
        "renders": [
          {
            "id": "01k5gh78...",
            "status": "done",
            "created_at": "2025-01-24T11:00:00.000000Z"
          }
        ],
        "timeline": {
          "compositionWidth": 1080,
          "compositionHeight": 1920,
          "tracks": [...],
          "items": {...},
          "assets": {...}
        }
      },
      {
        "id": "01k4ef57yqtsyrzjb0gveqy8de",
        "title": "Momento viral #2",
        "start_time": 512.0,
        "end_time": 571.5,
        "score": 87,
        "status": "face_analysis_done",
        "has_render": false,
        "feedback": null,
        "created_at": "2025-01-24T10:35:00.000000Z",
        "renders": [],
        "timeline": {...}
      }
    ],
    "first_page_url": "...",
    "from": 1,
    "last_page": 3,
    "per_page": 10,
    "to": 10,
    "total": 24
  },
  "meta": {
    "average_score": 75.50,
    "average_duration": 58.30
  }
}

​
Entendendo a Pontuacao (Score)

A pontuacao indica a relevancia do corte identificado pela IA:
FaixaClassificacaoDescricao
80-100ExcelenteMomentos de alto engajamento potencial
60-79BomBons trechos para conteudo
40-59MedioPode funcionar com edicao
0-39BaixoMenos recomendado
Dica: Comece renderizando os cortes com maior pontuacao para maximizar o engajamento.

​
Obter Short Especifico

Para obter detalhes de um short especifico: 
GET /shorts/{projectId}/{shortId}

curl -X GET "https://api.realoficial.com.br/api/v1/shorts/PROJECT_ID/SHORT_ID" \
  -H "Authorization: Bearer seu_token_aqui"
Retorna o objeto completo do short incluindo a timeline para edicao.