動画を取得
/api/v1alpha1/videos/{video_id}1本の動画と、その処理の進み具合を返します。
- アクセス: alphaを有効にしたAPI keyと
READ_VIDEOS権限。 - 確認する項目:
status、progress、nestederrorobjectから、待つか、調査するか、runを開始するかを判断できます。 - 見つからない場合: 他のワークスペースの動画は、存在しない場合と意図的に区別できません。
認証
apiKey 場所: header
パスパラメーター
動画の識別子です。アップロードセッションの id で返ります。
レスポンスボディ
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/vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "created_at": "2026-08-08T10:00:00.000Z", "duration": 183.75, "error": { "code": "budget_exhausted", "detail": "", "next_action": "", "title": "" }, "error_message": "The video could not be processed.", "filename": "warehouse-inspection-2026-08-08.mp4", "frame_count": 4410, "id": "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "progress": 100, "source": "user", "status": "completed", "thumbnail_url": "https://cdn.example.test/media/vid_0190b5d4/thumbnail.jpg", "updated_at": "2026-08-08T10:06:12.000Z"}動画uploadを作成 POST
サーバーがdirectまたはmultipart upload sessionを選択します。requestには元のfilenameと正確なfilesizeだけを含め、content typeはfilenameからサーバーが決め、durationはprocessing中に測定します。動画のバイト列はstorageへ直接送信し、このAPIを通過しません。200 MiB以下は1回のPUT、それより大きい動画は10 MiBのmultipart chunkを使います。responseに選択したstrategyを返します。
動画upload sessionを取得 GET
owner-scoped upload sessionと永続化したresume progressを返します。activity stateを変更せず、storage targetも発行しません。fresh targetの発行にはPOST /api/v1alpha1/videos/{videoid}/upload/targetsを使います。内部storage identifierは返しません。