コンテンツへスキップ
Videos

動画upload sessionを取得

GET/api/v1alpha1/videos/{video_id}/upload

owner-scoped upload sessionと永続化したresume progressを返します。activity stateを変更せず、storage targetも発行しません。fresh targetの発行にはPOST /api/v1alpha1/videos/{video_id}/upload/targetsを使います。内部storage identifierは返しません。

認証

apiKey
認証Bearer <token>

場所: header

パスパラメーター

video_id*string

動画の識別子です。アップロードセッションの 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/upload" \  -H "Authorization: Bearer $DEEPFRAME_API_KEY"
{  "chunk_size": 10485760,  "completed_parts": 2,  "expires_at": "2026-08-08T10:15:00.000Z",  "file_size": 157286400,  "received_parts": [    1,    3  ],  "reported_bytes": 20971520,  "state": "open",  "strategy": "direct",  "target": {    "expires_at": "2026-08-08T10:15:00.000Z",    "headers": {},    "method": "put",    "part_number": 2,    "url": "https://s3.example.test/upload"  },  "targets": [    {      "expires_at": "2026-08-08T10:15:00.000Z",      "headers": {},      "method": "put",      "part_number": 2,      "url": "https://s3.example.test/upload"    }  ],  "total_chunks": 16,  "uploaded_bytes": 10485760,  "verified_bytes": 0,  "video_id": "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab"}