# Início Rápido de Dublagem

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](https://portal.startpinch.com/dashboard/developers)
- 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

```bash
# 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:

```bash
# 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:

```plaintext
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](/content/docs/dubbing-api/index.html) — documentação completa dos endpoints
- [Painel de Dublagem](https://portal.startpinch.com/dashboard/dubbing) — duble áudio e vídeo pelo navegador
- [Tutorial Python](/content/guides/how-to-dub-videos-with-python/index.html) — guia completo com processamento em lote