API 概要

VocalLab API を使うと、音声の生成、ボイス一覧の取得、残高の確認を、自分のアプリ・スクリプト・自動化ツールからプログラムで実行できます。

Studio プランが必要です。 API アクセスは Studio に含まれています。Developer settings でキーを作成してください。

ベース URL

https://api.vocallab.ai

認証

すべてのリクエストで、API キーを Bearer トークンとして送信します:

Authorization: Bearer vl_live_...

キーは Developer ページで作成・無効化します。キーはパスワードと同じように扱ってください。表示されるのは一度きりで、キーを知っている人は誰でもあなたのポイントを消費できます。API Keys を参照してください。

できること

• 音声を生成 — POST /api/v1/tts（任意で model を渡せます）
• ボイス一覧を取得 — GET /api/v1/voices（カタログ + あなたのクローン・デザインしたボイス）
• モデル一覧を取得 — GET /api/v1/models（VocalLab Studio / Pro / Lite）
• ステータス確認 / ホスト URL の取得 — GET /api/v1/tts/:id
• 残高を確認 — GET /api/v1/ping または GET /api/v1/me

モデルを選ぶ

POST /api/v1/tts に "model" を渡してエンジンを選びます（既定は v-pro）:

• v-studio — VocalLab Studio: 最新、ステアリング対応（表現の指示に従う）、200 以上の言語。
• v-pro — VocalLab Pro: 最高音質、15 言語。既定。
• v-lite — VocalLab Lite: 高速で経済的 — 半分のポイントで課金されます。

API キーは 3 つすべてを利用できます。詳細は Voice Models を参照してください。

詳細は API Reference を参照してください。

課金

API による生成は、Web アプリと同じポイント残高を消費します。コストは最終的な音声の長さではなく、テキストの長さから計算されます:

• API: points = ⌈ characters ÷ 15 ⌉ — 1 ポイントあたり約 15 文字。
• Web アプリは 1 ポイントあたり 17 文字で課金するため、API にはプログラムアクセス向けのわずかな（約 13%）プレミアムが乗ります。

points_used はすべての生成で返されます。ポイントは Inworld の呼び出しの前に計測されるため、残高を超えて消費することはありません — ポイント不足のリクエストは 402 を返します。音声は平均で 1 秒あたり約 15〜17 文字のため、1 ポイント ≈ 音声 1 秒は目安として近いですが、正確な課金は常に上記の文字数の式に従います。

AI ツールの中で使う

Claude、Cursor、その他の AI アシスタントを使いたいですか? MCP server は同じ機能をネイティブツールとして提供します。ホスト版を使えばインストールするものは何もありません。