API de Upload

API de Upload

A API de Upload permite que você envie arquivos de vídeo ou áudio locais para a WayinVideo. Após o upload, use o identificador de arquivo retornado como video_url em outros endpoints da API (Clipping com IA, Buscar Momentos, Resumo de Vídeo, Transcrição de Vídeo).

Assinatura Necessária: O upload de arquivos locais requer um plano Standard ou superior. Diferentes planos têm limites de tamanho individual de arquivo e armazenamento total. Consulte a página de Planos de Assinatura para mais detalhes.

Limite de Tamanho: O limite de tamanho de arquivo único para uploads locais é de 5 GB. Se precisar de um limite maior, entre em contato conosco em wayinvideo@wayin.ai.

Formatos suportados: Você deve enviar um arquivo de vídeo válido. Formatos suportados atualmente: avi, mp4, mov, webm. O envio de outros formatos pode causar falha no processamento da tarefa após a submissão.

Fluxo de Upload

1. Solicite uma URL de upload pré-assinada fornecendo os metadados do arquivo
2. Envie o arquivo diretamente para a URL pré-assinada usando uma requisição PUT
3. Use o valor identity retornado como video_url nas chamadas de API subsequentes

Obter URL de Upload

Solicite uma URL de upload temporária para um arquivo local.

POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file

Corpo da Requisição

Exemplo de Requisição

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/upload/single-file \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"name": "sample-video.mp4"}'

Resposta

{
  "data": {
    "upload_url": "https://storage.example.com/upload/presigned-url...",
    "identity": "file_abc123"
  }
}

Enviar o Arquivo

Use o upload_url para enviar seu arquivo com uma requisição PUT:

curl -X PUT "https://storage.example.com/upload/presigned-url..." \
  -H "Content-Type: video/mp4" \
  --data-binary @/Users/me/Videos/sample-video.mp4

Nota: Se você enviar novamente usando o mesmo upload_url, o novo arquivo substituirá o anterior. Cada arquivo não pode exceder 5 GB.

Usar o Arquivo Enviado

Após o upload, passe o valor identity como video_url ao enviar tarefas.

Nota: Cada identity é válido por 24 horas. Com cota suficiente, você pode usar o mesmo identity para enviar múltiplas tarefas dentro de 24 horas.

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "THE_IDENTITY_VALUE", "enable_export": false}'

Perguntas Frequentes

Quando devo enviar um arquivo local em vez de passar uma URL de origem?

Se seu vídeo já existe em uma plataforma suportada (YouTube, Vimeo, TikTok, Zoom etc.), passe a URL diretamente para o endpoint de processamento — não é necessário fazer upload. Use a API de Upload apenas para arquivos que ainda não estão hospedados em uma fonte suportada.

Qual é o tamanho máximo do arquivo de upload?

5 GB por arquivo. Entre em contato em wayinvideo@wayin.ai se seu caso de uso exigir um limite maior.

Quais formatos de arquivo são suportados?

mp4, mov, webm, avi. Arquivos apenas de áudio devem ser empacotados em um desses formatos de contêiner antes do upload. Outros formatos podem falhar durante o processamento.

O upload conta na cota de armazenamento do meu plano?

Sim — os arquivos enviados consomem armazenamento do seu plano de assinatura. Consulte Planos de Assinatura para os limites de armazenamento e de tamanho por arquivo de cada plano.

Como uso o arquivo enviado em outras chamadas de API?

Após o upload, passe o identificador de arquivo retornado como campo video_url em qualquer endpoint de processamento — AI Clipping, Find Moments, Video Summarization ou Video Transcription.