API リファレンス

X-RateLimit-Limit-Minute: 120
X-RateLimit-Remaining-Minute: 118
X-RateLimit-Limit-Hour: 3000
X-RateLimit-Remaining-Hour: 2941
Retry-After: 42            # 429 のときのみ

curl -X POST https://api.avacast.jp/v1/sessions \
  -H "Authorization: Bearer $AVACAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "avatar_id": "avt_xxxxxxxx", "voice": { "language": "ja", "speed": 0.9 } }'

{
  "session_id": "ses_xxxxxxxx",
  "client_token": "eyJhbGciOi...",
  "webrtc": {
    "signaling_url": "https://.../offer",
    "events_url": "https://.../events",
    "ice_servers": [{ "urls": "turn:...", "username": "...", "credential": "..." }]
  },
  "expires_at": "2026-09-05T12:30:00.000Z"
}

curl -X POST https://api.avacast.jp/v1/sessions/ses_xxxxxxxx/speak \
  -H "Authorization: Bearer $AVACAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "ご相談ありがとうございます。" }'

{ "utterance_id": "utt_xxxxxxxx", "status": "queued", "queue_length": 1 }

curl -X POST https://api.avacast.jp/v1/sessions/ses_xxxxxxxx/interrupt \
  -H "Authorization: Bearer $AVACAST_API_KEY"

{ "interrupted_utterance_id": "utt_xxxxxxxx", "discarded_count": 2 }

curl https://api.avacast.jp/v1/sessions/ses_xxxxxxxx \
  -H "Authorization: Bearer $AVACAST_API_KEY"

{
  "session_id": "ses_xxxxxxxx",
  "status": "active",
  "end_reason": null,
  "queue_length": 0,
  "connected_seconds": 312,
  "total_speak_ms": 7500,
  "expires_at": "2026-09-05T12:30:00.000Z"
}

curl -X DELETE https://api.avacast.jp/v1/sessions/ses_xxxxxxxx \
  -H "Authorization: Bearer $AVACAST_API_KEY"

{ "session_id": "ses_xxxxxxxx", "status": "ended", "connected_seconds": 312, "total_speak_ms": 7500 }

curl https://api.avacast.jp/v1/avatars \
  -H "Authorization: Bearer $AVACAST_API_KEY"

{
  "data": [
    { "id": "avt_xxxxxxxx", "name": "案内役A", "languages": ["ja", "en"], "is_preset": true }
  ]
}

curl https://api.avacast.jp/v1/usage \
  -H "Authorization: Bearer $AVACAST_API_KEY"

# 期間を指定して、metadata.tenant の値ごとに分ける
curl "https://api.avacast.jp/v1/usage?from=2026-10-07T03:12:00Z&to=2026-11-07T03:12:00Z&group_by=metadata.tenant" \
  -H "Authorization: Bearer $AVACAST_API_KEY"

{
  "period": { "start": "...", "end": "..." },
  "connected_seconds": 18640,
  "total_speak_seconds": 4820,
  "session_count": 312,
  "utterance_count": 2914,
  "limits": { "concurrency": 10, "monthly_connected_seconds": null }
}

// from / to / group_by を付けたとき
{
  "period": { "start": "2026-10-07T03:12:00.000Z", "end": "2026-11-07T03:12:00.000Z" },
  "connected_seconds": 5520,
  "session_count": 41,
  "group_by": "metadata.tenant",
  "data": [
    { "key": "clinic-a", "connected_seconds": 3600, "session_count": 25 },
    { "key": "clinic-b", "connected_seconds": 1800, "session_count": 15 },
    { "key": null, "connected_seconds": 120, "session_count": 1 }
  ]
}

await fetch('https://api.avacast.jp/v1/client/sessions/ses_xxxxxxxx/speak', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${clientToken}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ text: 'ご相談ありがとうございます。' }),
});

{ "utterance_id": "utt_xxxxxxxx", "status": "queued", "queue_length": 1 }

curl https://api.avacast.jp/v1/status

{ "ok": true }

<video id="avatar" autoplay playsinline></video>
<script type="module">
  import { AvacastSession } from 'https://avacast.jp/sdk/v1.js';

  // client_token と webrtc はサーバーで作ったセッションのレスポンスから受け取る (API キーは出さない)
  const session = new AvacastSession(client_token, {
    signalingUrl: webrtc.signaling_url,
    iceServers: webrtc.ice_servers,
  });
  session.attach(document.getElementById('avatar'));
  // 映像が届いてから (session.ready) 喋らせる。届く前の speak は 409 になる
  session.on('session.ready', () => session.speak('ご相談ありがとうございます。'));
  session.on('speak.ended', () => askNextQuestion());
  await session.start();
</script>

https://api.avacast.jp/v1/mcp

# Claude Code なら (追加の後、/mcp からブラウザでログイン)
claude mcp add --transport http avacast https://api.avacast.jp/v1/mcp

# API キーでつなぐなら
claude mcp add --transport http avacast https://api.avacast.jp/v1/mcp \
  --header "Authorization: Bearer sk_live_..."

{
  "error": {
    "code": "session_not_found",
    "message": "Session ses_xxxxxxxx was not found."
  }
}