# avacast

> テキストを渡すだけで、喋るアバターの映像をブラウザへ WebRTC で配信する API。
> 日本語・英語・中国語をはじめ、多言語に対応。台本をその言語で渡すと、同じアバターがその言語で話す。
> 運営: シャノン合同会社 (SHANNON LIMITED LIABILITY COMPANY) https://shannon.co.jp/

- サイト: https://avacast.jp/
- API リファレンス: https://avacast.jp/docs
- 料金: https://avacast.jp/#pricing (Free 月 30 分 / Starter ¥1,980 / Standard ¥9,800 / Business ¥49,800、税抜、接続分数で課金)
- お問い合わせ: https://avacast.jp/contact
- API のベース URL: https://api.avacast.jp/v1
- MCP サーバー (AI エージェント用): https://api.avacast.jp/v1/mcp
- 全文ドキュメント (Markdown): https://avacast.jp/llms-full.txt
- エージェント用スキル (組み込み手順): https://avacast.jp/skill/SKILL.md
- Claude Code プラグイン: https://avacast.jp/plugin/marketplace.json

## MCP で使う (AI エージェント向け)

MCP 対応のエージェント (Claude Code、Cursor、Codex など) は `https://api.avacast.jp/v1/mcp` を
Streamable HTTP で繋いで、組み込みから有料化まで進められる。

1. URL を追加すると MCP クライアントがブラウザを開く。利用者が管理画面 (https://app.avacast.jp) のアカウントで
   ログインして「許可する」を押すとつながる (OAuth。API キーは要らない)。できることは管理画面と同じ役割
   (組織のオーナーはすべて、メンバーは見るだけ)。複数の組織に入っている人は `list_organizations` で ID を確かめ、
   各 tool の `organization_id` に渡す
2. MCP は OAuth でだけつなぐ。API キー (ヘッダ `Authorization: Bearer sk_live_…` や tool の引数 `api_key`) では
   繋げない (401)。OAuth に対応した MCP クライアントを使う。API キーは利用者のサーバーから REST API を呼ぶためのもので、
   管理画面か `create_api_key` で発行する
3. `get_integration_guide` (API・SDK・料金・エラーの全文) → `list_avatars` / `create_avatar` →
   `create_session` → `speak` → `end_session`。使用量は `get_usage`、料金表は `list_plans`
4. 有料化とプランの変更は `create_checkout(plan)` が URL を返す。利用者がブラウザで開いて確定する
   (はじめての申し込みは Stripe Checkout、有料プランの間の変更は管理画面の確認画面)。
   月間の上限を下げるのは `set_spending_cap(minutes)`、上げる・外すのは管理画面

tools: list_organizations / whoami / get_integration_guide / list_plans / get_account / list_voices /
list_avatars / create_avatar / get_avatar / delete_avatar / create_session / speak / interrupt / get_session /
end_session / list_sessions / get_usage / create_api_key / create_checkout / set_spending_cap / get_billing_portal

## 使い方 (要約)

1. サインアップして API キーを発行する (商談・審査なし)
2. `POST /v1/sessions` でセッションを作る。`client_token` と `webrtc` (signaling_url / events_url / ice_servers) が返る
3. ブラウザで JS SDK を使うか、WebRTC の offer を signaling_url に POST して映像と音声を受ける
4. `POST /v1/sessions/:id/speak` にテキストを送ると、アバターが喋る。発話イベントは events_url (SSE) に届く
5. `DELETE /v1/sessions/:id` で終了。課金はセッションが開いていた時間 (接続分数)

## 組織とメンバー

- API キー・アバター・請求は組織 (テナント) ごとに分かれる。組み込み先の顧客ごとに組織を分けて運用できる
- 1 つのアカウントで複数の組織に参加でき、管理画面の上部のプルダウンで切り替える。招待のときに役割
  (オーナー / メンバー) を選ぶ。無料プランの組織は 1 人 1 つまで

## 用途

内部通報の一次受付、顧客対応の窓口、採用の一次面接、社内相談の窓口、受付・来客案内、社内研修。
応答の生成や音声認識は含まない (avacast は渡されたテキストを喋るだけ)。