ページの一覧

ドキュメント

料金と請求

voicast の料金(1 分 10 円の従量)と払い方。お支払いはカードのチャージ式だけです。オートチャージ・チャージの期限・エンタープライズの個別の値段。

Markdown で見る

料金#

項目 内容
値段 1 分 10 円(税抜)。月額・初期費用はありません
数えるもの つながってから切れるまでの会話の秒数。電話と Web・アプリの区別はありません
環境 本番とテストの環境の会話を同じく数えます。無料の分数はありません
消費税 10%(外税)。チャージで足します
含まないもの 電話番号・回線・通話料(Twilio などサービスの側の契約)

音声認識・生成 AI・音声合成・要約・連携・録音の保存(保存期間のあいだ。最長 30 日)は料金に含まれます。

払い方#

お支払いはカードのチャージ式だけです(エンタープライズの契約の組織も同じです)。請求書払い・銀行振込は受けていません。

チャージ式
払うとき 先に残高を入れる
支払い カード
1 分の値段 10 円(エンタープライズは契約で決めた値段)
引き方 会話が終わるごとに残高から引く

チャージ式#

前払いの残高から、会話が終わるごとに 秒数 × 1 分の値段 ÷ 60 を引きます。1 分 10 円なら、30 秒の会話は 5 円です。

チャージ#

  • 管理画面の「組織の設定」→「請求」か、MCP の create_topup で行います(owner だけ)。API キーからは POST /v1/billing/topups { amount_yen } でチャージの URL を作れます(支払いは利用者がブラウザで行います)。
  • 1 回 500〜300,000 円(税抜、1 円単位)。3,000・5,000・10,000・30,000 円はすぐ選べます。
  • 消費税を足してカードで払います。支払いごとに適格請求書(登録番号つき)ができます。
  • 最初のチャージで使ったカードを保存し、オートチャージに使います。

期限#

チャージには、それぞれ 6 か月の期限があります。期限の早いチャージから使い、期限が来たら残りは消えます。残高と次に期限が来る額は、管理画面の「請求」・MCP の get_billing・API の GET /v1/billing で確かめられます。会話ごとの利用料は、会話の billed_yen で分かります。

残高が無くなったとき#

  • 残高が 0 以下になると、新しい会話を断ります。電話は音声サーバーがすぐに接続を閉じ(Twilio は次の処理へ進みます)、Web・アプリは POST /v1/sessions が 402 balance_depleted になります。
  • 始まった会話は途中で切りません。長い会話のあとは残高が少し負になり、次のチャージで埋まります。
  • 残高が 0 以下になった会話で、Webhook の billing.balance_depleted とメール(owner あて)で知らせます。

オートチャージ#

残高がしきい値を下回ったら、保存したカードで決めた額を自動でチャージします。管理画面の「請求」で設定します。

設定 範囲
しきい値 1〜300,000 円(例: 1,000 円)
チャージの額 500〜300,000 円
月の上限 今月のオートチャージの合計の上限(無しも可)
  • 月の上限を超えるオートチャージはせず、Webhook の billing.cap_reached(kind: 'auto_recharge')で知らせます。
  • カードで断られたら billing.recharge_failed とメールで知らせ、時間をおいて払い直します。3 回続けて断られたら、オートチャージを止めます。
  • オートチャージを使わないときは、残高がしきい値を下回ったときに billing.balance_low を 1 回送ります。
  • 月の上限は管理画面の「請求」で決めます。MCP の set_spending_cap では下げるだけができ、上げる・外すのは管理画面だけです。月の上限に届いても、残高があるあいだは会話を断りません。

エンタープライズの契約#

利用の多い組織は、組織ごとの契約で 1 分の値段(個別の値段)を決められます。お問い合わせください。

  • 契約の値段は、管理画面の「請求」に見るだけで出ます。次に終わる会話から、その値段で残高から引きます。
  • お支払いは、ほかの組織と同じくカードのチャージ(オートチャージも使えます)です。請求書払い・銀行振込はありません。

テストの環境#

テストの環境の会話も、本番と同じ値段で数え、残高から引きます。残高・今月の利用にも入ります。開発中の試しの会話は短く済ませ、自動のテストで会話をつなぐときは回数に気をつけます。

利用の内訳#

GET /v1/usage(MCP は get_usage)で、環境の会話の数・秒数・分数・金額の目安を引けます。サービスの側で、自社の顧客(テナント)に請求するときの内訳に使えます。

bash
curl "https://api.voicast.jp/v1/usage?from=2026-09-01&to=2026-09-30&group_by=tenant" \
  -H "Authorization: Bearer $VOICAST_API_KEY"
json
{
  "environment": "live",
  "from": 1788188400000,
  "to": 1790780400000,
  "group_by": "tenant",
  "filter": { "channel": null, "tenant_id": null, "external_id": null },
  "unit_price_yen": 6,
  "total": { "calls": 412, "seconds": 61230, "minutes": 1021, "amount_yen": 6123 },
  "data": [
    {
      "tenant": { "id": "ten_…", "external_id": "clinic-123", "name": "さくら歯科" },
      "calls": 120, "seconds": 17940, "minutes": 299, "amount_yen": 1794
    }
  ]
}
クエリ 内容
from・to 日付(YYYY-MM-DD、日本時間。to はその日を含む)か Unix ミリ秒(to はその時刻を含まない)。省くと今月の始まりから今まで。366 日まで
group_by tenant(テナントごと)・day(日ごと)・channel(電話 phone と Web web)
channel 経路で絞る(phone・web)
tenant_id・external_id テナントで絞る(ID か、サービス側の顧客 ID)
  • 数えるのは、期間内に終わった会話です。
  • 絞り込みは一緒に使えます。電話の分数だけをテナントごとに請求するなら group_by=tenant&channel=phone、1 つの顧客の分なら external_id=clinic-123&channel=phone です。
  • minutes はまとまりごとに秒の合計を 60 で割って切り上げた分数、amount_yen は秒数 ÷ 60 × 1 分の値段を円に丸めた目安(税抜)です。
  • 組織の実際の金額は、会話ごとに残高から引いた額です。

請求書と領収#

  • チャージ・オートチャージの請求書(適格請求書・領収書)・カードの変更・請求先は、管理画面の「請求」→「請求の管理」(Stripe の画面)で扱います(owner だけ)。
  • 残高の動き(チャージ・会話・期限切れ)は、管理画面の「請求」で 1 件ずつ見られます。

規約#

組織を削除しても、残高は返金しません(削除)。料金・チャージ・期限・返金の条件は、利用規約と特定商取引法に基づく表記に定めています。会話の記録・録音の取り扱いと委託先はプライバシーポリシーをご覧ください。