本文へ移動
使い方

ドキュメントを検索

検索はブラウザー内で行われ、入力した語句は送信・保存されません。認証情報は入力しないでください。

検索データを読み込み中…

Tab または矢印キーで移動 · Enter で開く · Esc で閉じる
ドキュメントを探す

動画アップロードを準備

POST /video-uploadsの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。

公開ベータAPI v1 · 1.5.0最終確認
このページの目次

操作

POST /video-uploads

operationId: create_video_upload_v1_video_uploads_post

最大100 MiB、30秒の非公開MP4/MOV/WebMアップロードを準備します。バイト転送後に完了してください。深度処理や生成は開始しません。

認証と副作用

サーバー側のBearer APIキーを使います。必要な権限:animations:write

有料生成は始めません。ほかの状態変更は上記を確認してください。

パラメータ

パス、クエリ、操作固有のヘッダーパラメータはありません。

リクエスト本文 (application/json)

本文必須:true

フィールド 型 必須 既定値 制約 説明
byte_size integer はい — maximum: 104857600; exclusiveMinimum: 0 Exact byte count, at most 100 MiB. The source must be 2–30 seconds.
filename string はい — minLength: 1; maxLength: 240 Client filename, not a readable server path.
mime_type string はい — enum: "video/mp4", "video/quicktime", "video/webm" Actual MP4, MOV or WebM media type.

入れ子の全スキーマ:VideoUploadRequest

応答

HTTP 本文 説明
201 VideoUploadSession 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.

応答例

json
{
  "expires_at": "2026-08-30T00:00:00Z",
  "headers": {
    "Content-Type": "video/mp4",
    "X-AnimGen-Upload-Token": "illustrative-only"
  },
  "max_bytes": 104857600,
  "method": "PUT",
  "upload_id": "00000000-0000-4000-8000-000000000001",
  "upload_url": "https://uploads.example.invalid/illustrative-video"
}

関連ガイド

状態確認とダウンロード · エラーと安全な再試行

この記事は役に立ちましたか?

検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー

お困りですか?サポートへ