Videos
動画を一覧表示
GET
/api/v1alpha1/videosワークスペース内の動画を新しい順に返します。
- アクセス: alphaを有効にしたAPI keyと
READ_VIDEOS権限。 - フィルター:
status。 - ページング:
limitの既定値は25、最大は100。next_cursorをそのままcursorとして渡します。
各行のpublicなidが、他の動画向け呼び出しで使うvideo_idです。分析するときは、すでに持っているworkflow_idをPOST /api/v1alpha1/runsに渡してください。
認証
apiKey 認証Bearer <token>
場所: header
クエリパラメーター
cursor?string
前の応答のnext_cursorとして返されたopaqueなcursorです。decode、編集、組み立てをせず、そのままcursorとして渡してください。
limit?number
1ページで返すresource数です。既定値は25で、1から100まで指定できます。
形式
int32範囲
1 <= value <= 100デフォルト
25status?string
Coarse processing status: queued is waiting to start; processing is extracting, analyzing, or indexing; completed is searchable; failed ended with an error. Omit it to return all visible videos.
許容値
- "queued"
- "processing"
- "completed"
- "failed"
レスポンスボディ
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1alpha1/videos" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "data": [ { "created_at": "2026-08-08T10:00:00.000Z", "duration": 183.75, "filename": "warehouse-inspection-2026-08-08.mp4", "frame_count": 4410, "id": "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "progress": 100, "source": "user", "status": "completed", "updated_at": "2026-08-08T10:06:12.000Z" } ], "has_more": false, "next_cursor": "MDEyMzQ1Njc4OWFitSLKnTQIcJAwDPi07V5EGs76Im3F8rCuUshrBnHuUJY7_8Ie8Stea_TKuhKhDw5XkRdkBI3IKkvsKT9Kp60Wpx7CoTCGQW8FnalDILVbuy8wxvWWf_B8SA"}