動画アップロードを完了
POST /video-uploads/{upload_id}/completeの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。
このページの目次
操作
POST /video-uploads/{upload_id}/complete
operationId: finish_video_upload_v1_video_uploads__upload_id__complete_post
アップロード済み動画を検証し、再利用できるfile_idと長さ・寸法を返します。完了の再実行では同じファイルを返します。
認証と副作用
サーバー側のBearer APIキーを使います。必要な権限:animations:write
有料生成は始めません。ほかの状態変更は上記を確認してください。
パラメータ
| パラメータ | 位置 | 型 | 必須 | 制約/既定値 | 説明 |
|---|---|---|---|---|---|
upload_id |
path |
string |
はい | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
応答
| HTTP | 本文 | 説明 |
|---|---|---|
200 |
VideoFileResponse | Successful public response. Example values are illustrative. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
409 |
APIErrorEnvelope | Idempotency conflict; only IDEMPOTENCY_IN_PROGRESS is retryable with the original request. |
410 |
APIErrorEnvelope | Upload session expired; prepare a new upload. |
413 |
APIErrorEnvelope | Request or decoded image exceeds the configured limit. |
415 |
APIErrorEnvelope | Use supported image media types. |
422 |
APIErrorEnvelope | Video metadata or size is invalid. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
応答ヘッダー
| HTTP | ヘッダー | 型 | 説明 |
|---|---|---|---|
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
応答例
{
"byte_size": 1024,
"duration_seconds": 5,
"file_id": "00000000-0000-4000-8000-000000000001",
"height": 768,
"mime_type": "video/mp4",
"object": "file",
"sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"width": 768
}
関連ガイド
この記事は役に立ちましたか?
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー