주 콘텐츠로 건너뛰기

Vimeo AI API 사용 방법

이 기능은 엔터프라이즈 플랜이 필요합니다.

REST API 엔드포인트를 통해 프로그래매틱 방식으로 비디오에서 AI 작업을 트리거합니다. 전사, 번역, 더빙 및 질문 기능을 Vimeo 웹 인터페이스 없이 사용할 수 있습니다.

이 문서에서 다루는 내용:

Vimeo AI API를 누가 사용할 수 있나요?

Vimeo AI API는 엔터프라이즈 플랜 사용자만 사용할 수 있습니다. 업그레이드를 원하시면 계정 담당자에게 문의하시기 바랍니다.

사용 가능한 작업

API는 /videos/{id}/ai/* 아래의 네 가지 작업을 지원합니다:

  • 전사(Transcription) — 비디오의 음성에서 전사본 생성
  • 자막 번역(Subtitle Translation) — 자막을 지원하는 언어로 번역
  • 음성 더빙(Audio Dubbing) — 비디오의 음성을 다른 언어로 더빙
  • AskAI — 비디오 콘텐츠에 대해 질문하고 AI 생성 답변 받기

총 9개의 엔드포인트가 있습니다: 각 작업에 대해 POST 및 GET, 그리고 지원되는 언어를 위한 GET 엔드포인트 1개입니다.

작동 방식

모든 AI API 호출은 비동기식입니다:

  1. POST 요청을 전송하여 작업 시작 (예: /videos/{id}/ai/transcription)
  2. GET 요청으로 같은 엔드포인트에 상태 확인
  3. 작업이 완료되면 결과를 사용할 수 있습니다

각 호출은 단일 비디오를 대상으로 합니다. 일괄 엔드포인트는 없으므로 여러 비디오를 처리하려면 개별적으로 반복합니다.

인증: ai OAuth 범위

AI API 엔드포인트를 호출하려면 토큰에 새로운 ai 범위가 필요합니다. 개인 액세스 토큰을 생성할 때 추가할 수 있으며, 프로비저닝이나 수동 설정이 필요하지 않습니다.

AI 크레딧

API 요청은 동일한 AI 크레딧 풀에서 Vimeo 웹 인터페이스와 동일한 요금으로 차감됩니다. 예를 들어, 자막 번역은 여전히 비디오 1분당 언어당 10크레딧이 소요됩니다. 전체 세부 정보는 AI 크레딧 요금 및 정책을 참조하시기 바랍니다.

요청 제한

각 AI API 엔드포인트는 분당 10개 요청 (~시간당 약 600개 비디오)으로 제한됩니다. 더 높은 제한이 필요하면 계정 담당자가 계정에 대해 조정할 수 있습니다.

API 문서

완전한 엔드포인트 사양, 요청/응답 형식 및 예제는 developer.vimeo.com/api/reference/videos#ai에서 확인할 수 있습니다.

추천 다음 단계

관련 문서