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

Solicite uma URL de upload pré-assinada fornecendo os metadados do arquivo
Envie o arquivo diretamente para a URL pré-assinada usando uma requisição PUT
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

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`name`	string	Sim	—	Nome do arquivo com extensão (ex.: `"my-video.mp4"`)

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"
  }
}

Campo	Tipo	Descrição
`upload_url`	string	URL pré-assinada para upload do arquivo. Esta URL expira após 1 hora — conclua o upload dentro desse prazo. Se expirar, solicite uma nova URL.
`identity`	string	Identificador do arquivo para usar como `video_url` em outras APIs

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}'