API 概要
VocalLab API を使うと、音声の生成、ボイス一覧の取得、残高の確認を、自分のアプリ・スクリプト・自動化ツールからプログラムで実行できます。
詳しい手順を動画で見る · 英語
無料プランを含むすべてのプランで利用できます。 呼び出しごとにアカウントのポイントが消費されます（15 文字につき 1 ポイント）。Studio のサイドバーの API と MCP（または vocallab.ai の Developer ページ）でキーを作成してください。（AppSumo の買い切りライセンスは Tier 3 以上でフルアクセス。Tier 1・Tier 2 は制限付きアクセスで、リクエスト頻度の上限が低く、1 回あたりのリクエストも短めです）
ベース URL
https://api.vocallab.ai
認証
すべてのリクエストで、API キーを Bearer トークンとして送信します:
Authorization: Bearer vl_live_...
キーは Studio の API と MCP（または Developer ページ）で作成・無効化します。キーはパスワードと同じように扱ってください。表示されるのは一度きりで、キーを知っている人は誰でもあなたのポイントを消費できます。API Keys を参照してください。
できること
- 音声を生成 —
POST /api/v1/tts（任意でmodelを渡せます） - ボイス一覧を取得 —
GET /api/v1/voices（カタログ + あなたのクローン・デザインしたボイス） - モデル一覧を取得 —
GET /api/v1/models（VocalLab Studio / Studio Flash / Pro / Lite） - ステータス確認 / ホスト URL の取得 —
GET /api/v1/tts/:id - SRT 字幕をダウンロード —
GET /api/v1/tts/:id/captions（字幕行または単語単位） - ボイスをデザイン —
POST /api/v1/voices/designs/previews、続いてPOST /api/v1/voices/designsで保存 - ボイスをクローン —
POST /api/v1/voices/clones（短い録音 1 つを base64 で送信） - 残高を確認 —
GET /api/v1/pingまたはGET /api/v1/me
モデルを選ぶ
POST /api/v1/tts に "model" を渡してエンジンを選びます（既定は v-studio）:
v-studio— VocalLab Studio: 最新、ステアリング対応（表現の指示に従う）、200 以上の言語。既定。v-flash— VocalLab Studio Flash: 同じ 200 以上の言語で、約 5 倍高速、¾ のポイントで課金されます。ステアリングは非対応。v-pro— VocalLab Pro: 最高音質、15 言語。v-lite— VocalLab Lite: 高速で経済的 — 半分のポイントで課金されます。
API キーは 4 つすべてを利用できます。詳細は Voice Models を参照してください。
詳細は API Reference を参照してください。
課金
API による生成は、Web アプリと同じポイント残高を消費します。コストは最終的な音声の長さではなく、テキストの長さから計算されます:
- API:
points = ⌈ characters ÷ 15 ⌉— 1 ポイントあたり約 15 文字。 - Web アプリは 1 ポイントあたり 17 文字で課金するため、API にはプログラムアクセス向けのわずかな（約 13%）プレミアムが乗ります。
points_used はすべての生成で返されます。ポイントは 音声が生成される前に計測されるため、残高を超えて消費することはありません — ポイント不足のリクエストは 402 を返します。音声は平均で 1 秒あたり約 15〜17 文字のため、1 ポイント ≈ 音声 1 秒は目安として近いですが、正確な課金は常に上記の文字数の式に従います。
AI ツールの中で使う
Claude、Cursor、その他の AI アシスタントを使いたいですか? MCP server は同じ機能をネイティブツールとして提供します。ホスト版を使えばインストールするものは何もありません。