URLとAPIによる音声送信
インターフェースで直接URLから音声をインポートする方法と、APIでプログラム的に文字起こしを送信する方法：対象プラン、キー、認証、制限、ウェブフック。
ファイルアップロードに加えて、「手元にファイルがない」場合の方法が2つあります。インターフェースにメディアURLを貼り付ける方法（全ユーザー対象）と、APIで送信する方法（Profissionalプラン以上）です。文字起こしをシステムやPABX、自動化に統合するのに最適です。
1. インターフェースでURLからインポート
新しい文字起こし画面では、YouTubeを受け付ける同じオプションで、音声・動画ファイルの直接URL（https）も受け付けます。サーバーがメディアをダウンロードし、通常のフローに進みます：言語の選択（または自動検出）、プランのエンジン、再生時間に応じたサイクルコスト。プランの時間・サイズ制限も同様に適用されます。
2. 文字起こしAPI
利用できるユーザー
APIはProfissionalプラン（月額R$ 39,90）から利用できます。Premium、法人プラン、および同等のレガシープランを含みます。その他のプランでは、キー作成時にプランが対象外であるというエラーが返されます。
APIキー
- トークン形式:
vpt_live_...; - 秘密鍵は作成時に一度だけ表示されます。安全な場所に保管してください。当社は秘密鍵を保存せず、その指紋のみを保持します。
- アカウントごとに有効なキーは最大20個まで。いつでも任意のキーを失効させられます。
- インターフェース内の個人キー管理エリアは現在実装中です。アカウントにオプションが見つからない場合は、チケットを開いていただければ有効化します。
呼び出しの仕組み
認証はヘッダー Authorization: Bearer vpt_live_... で行います。ボディには、音声のURL（audio_url、httpsのみ）、結果を受け取るwebhookのURLを指定し、任意でエンジン、言語、エクスポート形式、冪等性キーを指定できます。
- レート制限: キーあたり毎分60リクエスト;
- サイズ: サーバーでダウンロードするURL音声は最大500MB。Premiumエンジンでは、最大5GBのURLを中間ダウンロードなしで直接読み取れます。
- コスト: サイトと同じサイクル（再生時間とエンジンによる）。
結果の受信（webhooks）
結果はHMAC-SHA256で署名されたwebhookで届きます（ヘッダー X-VPT-Signature と X-VPT-Event）。ペイロードを信頼する前に署名を検証してください。エンドポイントがダウンしている場合、プログレッシブバックオフで再送信します：約24時間にわたって最大6回試行。
httpsのURLのみ受け付け、セキュリティ上の理由から内部/プライベートアドレスをブロックします。音声が認証の背後にある場合は、APIを呼び出す前にストレージで一時署名URLを生成してください。
ファイルの公開URLがない場合（例：PABXの録音）？ エンタープライズ監査APIには、一時的なアップロード先URL（1時間有効）を返すアップロードエンドポイントがあります。大量の通話監査のユースケースであれば、営業にお問い合わせください。
よくある質問
キーの秘密鍵を失くしました。どうやって復元しますか？
復元はできません。キーを失効させて新しいキーを作成してください。秘密鍵は作成時にしか存在しません。
APIのドキュメントはありますか？
完全な統合リファレンスは、アクセス有効化の際に提供されます。チケットを開いて、ユースケースをお知らせください。
呼び出しでエンジンと言語を選択できますか？
はい、両方ともオプションパラメータです。指定しない場合は、プランのデフォルトエンジンと言語検出が使用されます。
APIの料金はサイトと異なりますか？
いいえ。同じサイクル、同じルールです（成功後のみ割引も同じ）。
漏えいしたキーはどうやって失効させますか？
キー管理（またはサポート経由）ですぐに失効させてください。失効すると、すぐにアクセスが遮断されます。
関連記事
疑問が解決しない場合: チケットを開いてください。通常優先度のチケットには24時間以内に回答いたします。