4Z API

Query Video muse-video

Endpoint: GET https://4zapi.com/v1/videos/{id}

Query the task status. status: queued means waiting → in_progress means generating (progress is the approximate progress) → completed means finished / failed means failed (automatically refunded). The seconds in the response is the request (billing) duration, not the actual video length. On failure, it returns { id, status: "failed", status_update_time, error }, where error is a string formatted as "[error code] description":

  • video_generation_failed: The model did not produce a video (content is non-compliant or upstream error), rewrite the prompt or try again later.
  • video_rejected: The video is deemed unqualified and has been discarded (e.g., incorrect orientation, shorter than requested), retry directly.

Parameters

  • id (path, string, required)