이 기능은 엔터프라이즈 플랜이 필요합니다.
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 호출은 비동기식입니다:
-
POST 요청을 전송하여 작업 시작 (예:
/videos/{id}/ai/transcription) - GET 요청으로 같은 엔드포인트에 상태 확인
- 작업이 완료되면 결과를 사용할 수 있습니다
각 호출은 단일 비디오를 대상으로 합니다. 일괄 엔드포인트는 없으므로 여러 비디오를 처리하려면 개별적으로 반복합니다.
인증: ai OAuth 범위
AI API 엔드포인트를 호출하려면 토큰에 새로운 ai 범위가 필요합니다. 개인 액세스 토큰을 생성할 때 추가할 수 있으며, 프로비저닝이나 수동 설정이 필요하지 않습니다.
AI 크레딧
API 요청은 동일한 AI 크레딧 풀에서 Vimeo 웹 인터페이스와 동일한 요금으로 차감됩니다. 예를 들어, 자막 번역은 여전히 비디오 1분당 언어당 10크레딧이 소요됩니다. 전체 세부 정보는 AI 크레딧 요금 및 정책을 참조하시기 바랍니다.
요청 제한
각 AI API 엔드포인트는 분당 10개 요청 (~시간당 약 600개 비디오)으로 제한됩니다. 더 높은 제한이 필요하면 계정 담당자가 계정에 대해 조정할 수 있습니다.
API 문서
완전한 엔드포인트 사양, 요청/응답 형식 및 예제는 developer.vimeo.com/api/reference/videos#ai에서 확인할 수 있습니다.
추천 다음 단계
- AI 크레딧 정보 — 크레딧 잔액 및 사용량 확인
-
개인 액세스 토큰 생성 방법 —
ai범위로 인증 설정 - 요청 제한 — API 요청 제한 검토