ドキュメントVideo Status
Video

GET /unified-video/:taskId/status

Look up progress for a video generation task when you need manual status checks or a fallback to callback delivery.

GET /unified-video/:taskId/status権限: api.generate

向いている用途

Teams building history pages, task tracking, and result states.

Manual lookup
Fallback checks
Completion and failure states

呼び出し例

json

{
  "model": "seedance-1.5-pro",
  "prompt": "黃昏海邊的電影感鏡頭,光線柔和,海浪慢慢推進",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 8
}

What this API is for

The main completion path should be callback or webhook delivery.

Use this endpoint when you need a manual check, recovery path, or fallback instead of treating polling as the default workflow.

Parameters

taskId

Required path parameter. The taskId returned by /unified-video/generate.

Response fields

success

Whether the lookup succeeded.

taskId

Current task id.

status

Current task status.

output / assets

Generated output when complete, if available.

error

Failure detail when the task fails.

Frontend notes

  • Translate raw status values into customer-facing labels.
  • Keep progress visible in the task history area when doing manual checks.
  • On failure, show a clear explanation and allow retry from the original setup.

すぐに試したいですか?

Settings で general API key を作成してから、ここに戻ってリクエスト例をコピーしてください。

API キーを開く