AI動画ノート
動画URLからBaidu AIを使用して構造化されたノートを生成します。3種類のノート形式に対応しています。
ワークフロー
- タスク作成: 動画URLを送信 → タスクIDを取得
- ステータス確認: 3〜5秒ごとにタスクを問い合わせ、完了するまで待機
- 結果取得: ステータスが10002になったら生成されたノートを取得
ステータスコード
| コード | ステータス | アクション |
|---|---|---|
| 10000 | 処理中 | ポーリングを継続 |
| 10002 | 完了 | 結果を返す |
| その他 | 失敗 | エラーを表示 |
ノートタイプ
| タイプ | 説明 |
|---|---|
| 1 | 文書ノート |
| 2 | アウトラインノート |
| 3 | グラフィックテキストノート |
API
タスク作成
エンドポイント: POST /v2/tools/ai_note/task_create
パラメータ:
video_url(必須): 公開された動画URL
例:
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
レスポンス:
{
"task_id": "uuid-string"
}
タスク問い合わせ
エンドポイント: GET /v2/tools/ai_note/query
パラメータ:
task_id(必須): 作成エンドポイントから取得したタスクID
例:
python3 scripts/ai_notes_task_query.py "task-id-here"
レスポンス (完了時):
{
"status": 10002,
"notes": [
{
"tpl_no": "1",
"contents: ["ノート内容..."]
}
]
}
ポーリング戦略
オプション1: 手動ポーリング
- タスク作成 →
task_idを保存 - 3〜5秒ごとに問い合わせ:
python3 scripts/ai_notes_task_query.py <task_id> - 進捗を表示:
- ステータス10000: 処理中...
- ステータス10002: 完了
- 30〜60秒で停止(動画の長さに依存)
オプション2: 自動ポーリング(推奨)
ポーリングスクリプトを使用して自動的にステータスを更新:
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
例:
# デフォルト: 20回試行、3秒間隔
python3 scripts/ai_notes_poll.py "task-id-here"
# カスタム: 30回試行、5秒間隔
python3 scripts/ai_notes_poll.py "task-id-here" 30 5
出力:
- リアルタイムの進捗を表示:
[1/20] 処理中... 25% - 完了時に自動停止
- タイプラベル付きのフォーマットされたノートを返す
エラーハンドリング
- 無効なURL: "動画URLにアクセスできません"
- 処理エラー: "動画の解析に失敗しました"
- タイムアウト: "動画が長すぎます。後でもう一度お試しください"