Avançar para o conteúdo principal

Como usar a API de IA do Vimeo

Este recurso requer um plano Enterprise.

Acione ações de IA em seus vídeos de forma programática — transcreva, traduza, duble e faça perguntas através de endpoints da API REST, sem usar a interface web do Vimeo.

Neste artigo:

Quem pode usar a API de IA do Vimeo?

A API de IA do Vimeo está disponível apenas para usuários do plano Enterprise. Entre em contato com seu gerente de conta se deseja fazer upgrade.

Ações disponíveis

A API suporta quatro ações sob /videos/{id}/ai/*:

  • Transcrição — Gere uma transcrição do áudio do seu vídeo
  • Tradução de Legendas — Traduza legendas para idiomas suportados
  • Dublagem de Áudio — Duble o áudio do seu vídeo para outro idioma
  • AskAI — Faça perguntas sobre o conteúdo do seu vídeo e obtenha respostas geradas por IA

Há nove endpoints no total: POST e GET para cada ação, além de um endpoint GET para idiomas suportados.

Como funciona

Todas as chamadas da API de IA são assíncronas:

  1. Envie uma solicitação POST para iniciar um trabalho (por exemplo, /videos/{id}/ai/transcription)
  2. Verifique o status com uma solicitação GET para o mesmo endpoint
  3. Quando o trabalho é concluído, seu resultado está pronto

Cada chamada é direcionada a um único vídeo. Não há um endpoint em massa — para processar vários vídeos, faça um loop neles individualmente.

Autenticação: o escopo OAuth ai

Para chamar endpoints da API de IA, seu token precisa do novo escopo ai. Você pode adicioná-lo ao gerar um token de acesso pessoal — nenhum provisionamento ou configuração manual é necessária.

Créditos de IA

As solicitações da API utilizam o mesmo pool de créditos de IA da interface web do Vimeo, com as mesmas taxas. Por exemplo, a tradução de legendas ainda custa 10 créditos por minuto de vídeo por idioma. Veja Taxas e políticas de créditos de IA para detalhes completos.

Limites de taxa

Cada endpoint da API de IA é limitado a 10 solicitações por minuto (~600 vídeos por hora). Se você precisar de um limite mais alto, seu gerente de conta pode ajustá-lo para sua conta.

Documentação da API

As especificações completas dos endpoints, formatos de solicitação/resposta e exemplos estão em developer.vimeo.com/api/reference/videos#ai.

Próximos passos sugeridos

Artigos relacionados