この機能はエンタープライズプランが必要です。
REST APIエンドポイント経由で、ビデオに対するAIアクション(トランスクリプション、翻訳、ダビング、質問)をプログラムで実行できます。Vimeoウェブインターフェイスを使用する必要はありません。
この記事で扱う内容:
Vimeo AI APIを使用できるのは誰か?
Vimeo AI APIはエンタープライズプランユーザーのみが利用できます。アップグレードをご希望の場合はアカウントマネージャーまでお問い合わせください。
利用可能なアクション
APIは /videos/{id}/ai/* 配下の4つのアクションをサポートしています:
- トランスクリプション — ビデオの音声からトランスクリプトを生成
- 字幕翻訳 — 字幕をサポートされている言語に翻訳
- オーディオダビング — ビデオの音声を別の言語にダビング
- AskAI — ビデオのコンテンツについて質問し、AI生成の回答を取得
合計9つのエンドポイントがあります: 各アクションに対するPOSTとGET、およびサポートされている言語用のGETエンドポイント1つです。
仕組み
すべてのAI API呼び出しは非同期です:
-
POST リクエストを送信してジョブを開始します (例:
/videos/{id}/ai/transcription) - GET リクエストで同じエンドポイントのステータスをポーリングします
- ジョブが完了すると、結果が準備完了になります
各呼び出しは単一のビデオをターゲットとしています。バルクエンドポイントはなく、複数のビデオを処理するには個別にループする必要があります。
認証: ai OAuthスコープ
AI APIエンドポイントを呼び出すには、トークンが新しい ai スコープを必要とします。パーソナルアクセストークンを生成する際に追加できます。プロビジョニングや手動セットアップは不要です。
AIクレジット
APIリクエストはVimeoウェブインターフェイスと同じAIクレジットプールから消費され、同じレートで課金されます。例えば、字幕翻訳はビデオ1分あたり1言語につき10クレジットかかります。詳細は AIクレジット料金とポリシー をご覧ください。
レート制限
各AI APIエンドポイントは 1分あたり10リクエスト (1時間あたり約600ビデオ) に制限されています。より高い制限が必要な場合は、アカウントマネージャーがアカウント用に調整できます。
APIドキュメンテーション
完全なエンドポイント仕様、リクエスト/レスポンス形式、および例については、developer.vimeo.com/api/reference/videos#ai をご覧ください。
次のステップ候補
- AIクレジットについて — クレジット残高と使用状況を確認
-
パーソナルアクセストークンを生成する方法 —
aiスコープで認証をセットアップ - レート制限 — APIレート制限を確認