要約 · Cloudflare Realtime ドキュメント

RealtimeKit は、文字起こしデータから AI によるミーティング要約を生成します。

要約を有効にする

ミーティングを作成するときに summarize_on_end: true を設定します。ミーティング後の要約では、あわせて transcribe_on_end: true も設定します。文字起こしが揃ったあと、RealtimeKit が自動で要約を生成します。

curl -X POST "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/meetings" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Product Review",
    "transcribe_on_end": true,
    "summarize_on_end": true,
    "ai_config": {
      "transcription": {
        "language": "en-US"
      },
      "summarization": {
        "word_limit": 500,
        "text_format": "markdown",
        "summary_type": "team_meeting"
      }
    }
  }'

設定

オプション	型	デフォルト	説明
`word_limit`	number	500	要約の長さ（150〜1000 語）
`text_format`	string	`markdown`	出力形式: `plain_text` または `markdown`
`summary_type`	string	`general`	ミーティングの種類。要約の内容を合わせます

要約の種類

ミーティングの種類に合うタイプを選ぶと、結果がよくなります。

タイプ	適した用途
`general`	任意のミーティング（デフォルト）
`team_meeting`	定期的なチーム同期
`daily_standup`	アジャイルのスタンドアップ
`one_on_one_meeting`	1 対 1 のミーティング
`sales_call`	顧客とのセールス会話
`client_check_in`	クライアントの状況確認
`interview`	採用面接
`lecture`	教育コンテンツ
`code_review`	技術的なコードレビュー

要約を利用する

Webhook

RealtimeKit webhooks で meeting.summary イベントを設定すると、準備できたときに要約のダウンロード URL を受け取れます。

{
	"event": "meeting.summary",
	"meeting": {
		"id": "bbb8940e-1b97-402a-97d6-2708b7feca41",
		"sessionId": "05e57591-d89e-45c9-ae44-08dc1eaad0e0",
		"organizedBy": {
			"id": "c94c437b-592a-4a39-b9e2-47ef1451e43b",
			"name": "Example organization"
		}
	},
	"summaryDownloadUrl": "https://example.com/summary.txt",
	"summaryDownloadUrlExpiry": "2026-06-10T10:30:00.000Z"
}

REST API

要約を取得する

セッションの文字起こし要約を取得するを参照してください。

curl -X GET "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/sessions/$SESSION_ID/summary" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

手動で生成する

summarize_on_end を設定していない場合、文字起こしが揃ったあとでセッションの文字起こし要約を生成する API を使って、手動で要約を生成できます。

curl -X POST "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/sessions/$SESSION_ID/summary" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

出力例

text_format: "markdown" と summary_type: "team_meeting" の場合:

## Meeting Summary

### Key Discussion Points

- Reviewed Q4 roadmap priorities
- Discussed deployment timeline for v2.0
- Identified blockers for the auth migration

### Action Items

- @alice: Update design specs by Friday
- @bob: Schedule security review
- @charlie: Create migration runbook

### Decisions Made

- Approved moving forward with Kubernetes migration
- Delayed analytics dashboard to next sprint

保持期間

要約は、ミーティング終了後 7 日間 保存されます。