Skip to main content

​
Visão Geral

Com a API Mirage, você pode transcrever automaticamente o áudio do seu vídeo e renderizar legendas animadas diretamente no vídeo. Escolha entre uma variedade de modelos de legenda para combinar com sua marca ou visão criativa.

​
Pré-requisitos

Crie uma chave de API no painel da plataforma.

​
1) Escolha um Modelo de Legenda

Adicionar legendas a vídeos requer um modelo de legenda. Explore todos os modelos disponíveis na galeria de modelos de legenda ou obtenha-os programaticamente. Modelo de Exemplo: Heat
ID do Modelo de Legenda 
ctpl_DxflLOnuKkb198FNdI9E

​
2) Adicionar Legendas a um Vídeo

Envie seu vídeo junto com um ID de modelo de legenda. Você pode fazer upload de um arquivo de vídeo diretamente ou referenciar um ID de vídeo existente de uma geração anterior. 
import requests

url = "https://api.mirage.app/v1/videos/captions"
headers = {
    "x-api-key": "<api-key>"
}
files = {
    "video": open("input.mp4", "rb")
}
data = {
    "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E"
}

# Ou use um ID de vídeo existente em vez de fazer upload:
data = {
    "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E",
    "video_id": "video_abc123def456"
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
Resposta (exemplo) 
{
  "id": "video_cap789xyz",
  "object": "video",
  "status": "PROCESSING",
  "created_at": 1730822600,
  "progress": 0,
  "source_video_id": null,
  "caption_template_id": "ctpl_DxflLOnuKkb198FNdI9E"
}

​
3) Verificar Status do Job

Verifique periodicamente até que o status seja COMPLETE. 
import requests

url = f"https://api.mirage.app/v1/videos/{video_id}"
headers = {
    "x-api-key": "<api-key>"
}

response = requests.get(url, headers=headers)
print(response.json())
Valores de status
  • QUEUED
  • PROCESSING
  • COMPLETE
  • FAILED
  • CANCELLED

​
4) Baixar o Vídeo

Quando o status for COMPLETE, baixe seu vídeo legendado. 
import requests

url = f"https://api.mirage.app/v1/videos/{video_id}/content"
headers = {
    "x-api-key": "<api-key>"
}

response = requests.get(url, headers=headers, allow_redirects=True)

with open("captioned.mp4", "wb") as f:
    f.write(response.content)

​
Requisitos de vídeo

  • Proporção: 9:16 (vertical/retrato)
  • Tamanho máximo: 50 MB
  • Duração máxima: 5 minutos
  • Formatos: MP4, MOV

​
Referência da API

Last modified on March 10, 2026