メインコンテンツへスキップ

Vimeo AI APIの使用方法

この機能はエンタープライズプランが必要です。

REST APIエンドポイント経由で、ビデオに対するAIアクション（トランスクリプション、翻訳、ダビング、質問）をプログラムで実行できます。Vimeoウェブインターフェイスを使用する必要はありません。

この記事で扱う内容:

Vimeo AI APIを使用できるのは誰か?

Vimeo AI APIはエンタープライズプランユーザーのみが利用できます。アップグレードをご希望の場合はアカウントマネージャーまでお問い合わせください。

利用可能なアクション

APIは /videos/{id}/ai/* 配下の4つのアクションをサポートしています:

  • トランスクリプション — ビデオの音声からトランスクリプトを生成
  • 字幕翻訳 — 字幕をサポートされている言語に翻訳
  • オーディオダビング — ビデオの音声を別の言語にダビング
  • 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リクエストはVimeoウェブインターフェイスと同じAIクレジットプールから消費され、同じレートで課金されます。例えば、字幕翻訳はビデオ1分あたり1言語につき10クレジットかかります。詳細は AIクレジット料金とポリシー をご覧ください。

レート制限

各AI APIエンドポイントは 1分あたり10リクエスト (1時間あたり約600ビデオ) に制限されています。より高い制限が必要な場合は、アカウントマネージャーがアカウント用に調整できます。

APIドキュメンテーション

完全なエンドポイント仕様、リクエスト/レスポンス形式、および例については、developer.vimeo.com/api/reference/videos#ai をご覧ください。

次のステップ候補

関連記事