API de Transcrição

Envie mídias para transcrição por IA e criação de projeto. Suporta arquivos de Vídeo e Áudio.

POST/api/v1/transcribe

Implementação Rápida

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"

POSThttps://api.srtgen.com/api/v1/transcribe

Parâmetros da Solicitação

Parâmetro	Tipo	Obrigatório	Descrição
`file`	File	Yes	O arquivo de mídia a ser transcrito (Multipart). Suportados: Vídeo (mp4, mov, avi, webm, mkv), Áudio (mp3, wav, m4a, flac). Máx. 2GB.
`videoUrl`	String	No*	URL externa da mídia (obrigatória se o arquivo não for fornecido no corpo).
`name`	String	No	Nome personalizado para o projeto.
`languageCode`	String	No	Código do idioma de origem (ex: 'pt-br'). O padrão é 'auto' (detecção automática) se omitido.
`filterProfanity`	Boolean	No	Se deve censurar automaticamente palavras explícitas. O padrão é false.
`disfluencies`	Boolean	No	Se deve incluir pausas (ex: 'humm', 'ãnh'). O padrão é false.
`medicalMode`	Boolean	No	Transcrição otimizada para áudio médico/da área da saúde. O padrão é false.

Avançado: URL + Configurações de IA

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/medical_lecture.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false" \
  -F "medicalMode=true"

POSThttps://api.srtgen.com/api/v1/transcribe

Resposta de Sucesso

Uma solicitação bem-sucedida retorna um status 200 OK com o projeto e os detalhes da tarefa em segundo plano.

projectIdO identificador exclusivo para seu projeto.
status'inProgress' (transcrição em andamento).
Nota: Os créditos são calculados e deduzidos do seu saldo assincronamente após a finalização do processo de transcrição.

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

Códigos de Erro

Status	Código do Erro	Descrição
400	missing_file	Nenhum arquivo encontrado no campo 'file' ou 'video'.
400	unreachable_url	A videoUrl fornecida é inacessível ou retornou um erro.
400	invalid_parameter	Um dos parâmetros (ex: videoUrl) está malformado.
400	file_read_failed	O arquivo enviado não pôde ser lido ou está corrompido.
401	unauthorized	Chave de API ausente ou inválida.
403	insufficient_balance	Você não tem créditos suficientes para processar a duração desta mídia.
403	storage_quota_exceeded	O arquivo excede a cota de armazenamento em nuvem restante do seu plano.
413	payload_too_large	O arquivo excede o limite absoluto de upload de 2GB do sistema.
500	transcription_failed	A tarefa de transcrição não pôde ser iniciada (falha no provedor de IA).
500	server_error	Algo deu errado, tente novamente mais tarde.

Estrutura de Resposta de Erro

{
  "success": false,
  "error": "insufficient_balance",
  "message": "Seu projeto requer 5 créditos, mas seu saldo é 2."
}

Esta página foi útil?