コンテンツへスキップ
Videos

動画uploadを完了

POST/api/v1alpha1/videos/{video_id}/upload/complete

direct objectまたは永続化したmultipart receipt manifestを検証し、storage byte数を確認して、processingを1回だけ開始します。processing statusはGET /api/v1alpha1/videos/{video_id}でpollします。

認証

apiKey
認証Bearer <token>

場所: header

パスパラメーター

video_id*string

動画の識別子です。アップロードセッションの id で返ります。

ヘッダーパラメーター

Idempotency-Key?string

このPOSTを安全にretryするための任意のkeyです。keyは24時間保持され、request payloadと具体的なpath parameterと比較されます。

長さlength <= 255

リクエストボディ

application/json

TypeScript 型定義

TypeScript では request body 型を使用します。

レスポンスボディ

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

application/problem+json

curl -X POST "https://example.com/api/v1alpha1/videos/vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab/upload/complete" \  -H "Authorization: Bearer $DEEPFRAME_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
{  "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"}