Início Rápido de Dublagem

Este documento é uma tradução do Dubbing Quickstart em inglês. Última sincronização: 17 de março de 2026.

Duble áudio ou vídeo em outro idioma em 5 minutos. Sem SDK necessário — apenas chamadas REST API.

Pré-requisitos

• Uma chave API Pinch do Portal do Desenvolvedor
• Um arquivo de áudio (WAV, MP3, FLAC, OGG, M4A, AAC, WMA) ou vídeo (MP4, MOV, MKV, WebM, AVI) — ou uma URL pública

Exemplo rápido

# 1. Criar um trabalho de dublagem a partir de uma URL
curl -X POST https://api.startpinch.com/api/dubbing/jobs \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://exemplo.com/video.mp4",
    "source_lang": "auto",
    "target_lang": "pt"
  }'

# Resposta: { "job_id": "abc-123", "status": "pending", ... }

# 2. Verificar conclusão
curl https://api.startpinch.com/api/dubbing/jobs/abc-123 \
  -H "Authorization: Bearer SUA_CHAVE_API"

# 3. Baixar o resultado quando status for "completed"
curl https://api.startpinch.com/api/dubbing/jobs/abc-123/result \
  -H "Authorization: Bearer SUA_CHAVE_API"

# Resposta: { "download_url": "https://...", "expires_at": "..." }

Upload de arquivo local

Se seu arquivo não é acessível publicamente, faça upload primeiro:

# 1. Obter URL de upload pré-assinada
curl -X POST https://api.startpinch.com/api/dubbing/upload-url \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{"filename": "meu-video.mp4", "content_type": "video/mp4"}'

# Resposta: { "upload_url": "https://...", "source_url": "https://..." }

# 2. Upload direto para S3
curl -X PUT "UPLOAD_URL_DO_PASSO_1" \
  -H "Content-Type: video/mp4" \
  --data-binary @meu-video.mp4

# 3. Criar trabalho de dublagem usando source_url do passo 1
curl -X POST https://api.startpinch.com/api/dubbing/jobs \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "SOURCE_URL_DO_PASSO_1",
    "target_lang": "pt"
  }'

Ciclo de vida do trabalho

Os trabalhos passam por estes estados:

pending → downloading → processing → uploading → completed
                                                → failed

Faça polling em GET /api/dubbing/jobs/{id} para acompanhar o progresso. Tempo típico: 2-5 minutos por minuto de entrada.

Preços e limites

Preço	$0.50 por minuto de mídia de entrada
Duração máxima	10 minutos
Duração mínima	1 segundo
Tamanho máximo	500 MB
Formatos de entrada	Vídeo: MP4, MOV, MKV, WebM, AVI; Áudio: WAV, MP3, FLAC, OGG, M4A, AAC, WMA
Formato de saída	Vídeo: MP4 (H.264 + AAC); Áudio: MP3 ou WAV
Limite de taxa	10 trabalhos por minuto
Expiração	URLs de download expiram em 48 horas

Idiomas suportados

Código	Idioma
en	Inglês
es	Espanhol
fr	Francês
de	Alemão
it	Italiano
pt	Português
ru	Russo
ja	Japonês
ko	Coreano
zh	Chinês

Próximos passos

• Dubbing API Reference — documentação completa dos endpoints
• Painel de Dublagem — duble áudio e vídeo pelo navegador
• Tutorial Python — guia completo com processamento em lote