文字起こし API：概要、認証、制限

VoxScriber の REST API を使うと、サイトを経由せずに、URL で音声を送信して、そのまま文字起こし結果を自分のシステムで受け取れます。パネルでの文字起こしと同じエンジンを使用し、同じサイクルを消費します。

利用できるユーザー

API は Profissional プラン（月額 R$ 39,90） から利用できます。対象となるのは、Profissional、Premium、すべての Empresariais プラン（月払い・年払い）、および同等のレガシープランです。アカウントが対象でない場合、キー関連のルートは 403 PLAN_NOT_ELIGIBLE エラーを返します。

APIキー

個人キーの作成には、現在パネルに専用画面がありません。ご利用のプランが対象で、API を始めたい場合は、チケットを開いて ください。担当者がアクセスを有効化します。

認証

すべてのリクエストには、Authorization ヘッダーでキーを指定します。

Authorization: Bearer vpt_live_SUA_CHAVE

ヘッダーがないリクエストは 401 MISSING_API_KEY を返します。

音声を文字起こしに送信する

文字起こしエンドポイントはゲートウェイ api.voxscriber.com にあります。

curl -X POST https://api.voxscriber.com/v1/transcriptions \
  -H "Authorization: Bearer vpt_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://exemplo.com/gravacoes/reuniao.mp3",
    "webhook_url": "https://seusistema.com/webhooks/vozparatexto",
    "formats": ["txt", "srt"]
  }'

リクエストボディで受け付けられるフィールド: audio_url、webhook_url、engine（ASSEMBLYAI、WHISPER、ELEVENLABS）、language、formats（txt、json、srt、vtt、docx、pdf）、metadata、idempotency_key。結果は指定した webhook_url に届きます。Webhooks と通知 を参照してください。

制限

URLのセキュリティルール: https のみ、リダイレクトなし、内部/プライベートアドレスはブロックされます。音声の URL は公開アクセス可能である必要があります。

利用可能なエクスポート形式は、サイトと同様にプランのゲートに従います。プラン外の形式は exports_skipped にリストされて返されます。

課金

API は、サイトでの文字起こしと同じサイクルを、選択したエンジンに応じて消費します（Padrão/Whisper: 1サイクル/分、Premium: 4サイクル/分、Ultra: 10サイクル/分）。現時点では、月間の呼び出しクォータやキーごとの利用上限はありません。サイクル残高で消費量を管理してください。サイクルとは？1分あたりのコスト を参照してください。

FAQ

関連記事

• Webhooks と通知
• API で自動化する
• サイクルとは？1分あたりのコスト
• 他のツールへエクスポート

解決しませんか？チケットを開いて ください。担当者が迅速に対応します。