動画分析
提供中120秒以内の動画をアップロード。各ショットの時間範囲とフレーム、起きていること、転換点、結末、リメイク時に残すべき要素がわかります。
Break down video
動画をフレームとタイムスタンプ付きのショット別レポートに。
実行ごとに課金 · 動画は最長 120 秒 · 1 時間に 3 回まで
Files are processed privately and are not published. Analysis sends selected media to an AI model; temporary source files are removed afterward.
Open image generation and editingAPI endpoint
POST /v1/media/video-breakdownAuthenticate with an API key. Download accepts JSON with url and optional max_height; inspection accepts multipart file. Keys stay in memory.
出力例クリエイティブ・コモンズの予告編で実際に実行した結果です。自分のリンクやファイルで置き換えられます。
Big Buck Bunny trailer (CC) Blender Foundation | www.bigbuckbunny.org — CC BY 3.0, via Wikimedia Commons
仕組み
- 01動画を追加120秒以内のクリップをアップロード、またはリンクから先にダウンロード。
- 02レポートを受け取る各ショットの時間範囲、フレーム、内容。
- 03確認して活用フレームをクリックしてその場面へ移動、要確認の箇所を確認し、レポートを JSON で保存。
コードから 動画分析 を呼び出す
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成最初のリクエストを送る
プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。
curl https://api.opennan.com/v1/media/video-breakdown \ -H "Authorization: Bearer $OPENNAN_KEY" \ -F "[email protected]"結果を読む
結果は同じレスポンスで返ります。X-Usage-Cost-Usd ヘッダーに呼び出しの料金が入ります。
エラーと直し方
401キーがない、または間違っている
コンソールで作ったキーを Authorization: Bearer ヘッダーで送ってください。
402残高不足
請求ページで残高を追加し、同じ呼び出しをもう一度送ってください。
400受け付けられない値がある
error.message にフィールド名が出ます。パラメーター表の値を使ってください。
429リクエストが多すぎる
数秒待ってから再試行し、429 が続くたびに待ち時間を延ばしてください。
動画分析: よくある質問
動画分析 の料金は?
実行ごとに使った AI トークン分を支払います。実行の最大額を先に残高から確保し、残りは戻ります。AI がファイルを読む前に失敗した実行は課金されません。AI が読んだ後は、その後に失敗しても使ったトークン分が課金されます。
コードから呼び出すには?
API キーを付けて POST https://api.opennan.com/v1/media/video-breakdown を送ります。結果は同じレスポンスで返ります。
AI エージェントから使えますか?
はい。エージェントに https://api.opennan.com/llms.txt を読ませてください。このエンドポイントと他のすべてを説明しています。
実行が失敗したら?
失敗したリクエストには料金がかかりません。使ったトークン分だけ支払います。