PixVerse 系列

按固定优先级判定，命中即停：

1. 没有任何图片或延长字段 —— 文生视频
2. 传了 image_urls —— 图生视频，只取第一张
3. 同时传 first_frame_image 与 last_frame_image —— 首尾帧过渡
4. 传了 img_references —— 多图融合
5. 传了 extend_from_task_id —— 视频延长

Judged in a fixed priority order, stopping at the first match:

1. No image or extension fields — text to video
2. image_urls passed — image to video, using only the first image
3. Both first_frame_image and last_frame_image passed — first-and-last-frame transition
4. img_references passed — multi-image fusion
5. extend_from_task_id passed — video extension

• 所有图片必须是公网可达的 HTTP(S) 地址，不接受 Base64 与 data URI
• 首尾帧只能选 5 秒或 8 秒
• motion_mode 只接受 normal
• 延长任务的源任务必须是本人所有且已完成

• All images must be publicly reachable HTTP(S) addresses; Base64 and data URIs aren't accepted
• First-and-last-frame mode allows only 5 or 8 seconds
• motion_mode accepts only normal
• An extension task's source task must be owned by you and already completed

提交成功返回统一的受理结构：

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

A successful submission returns the standard accepted structure:

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

参数错误在提交阶段同步返回，不创建任务、不扣费。

余额不足时部分上游返回 403 quota_not_enough，响应体带上余额与所需金额。

更多状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

Parameter errors are returned synchronously at submission, creating no task and charging nothing.

When the balance is insufficient, some upstreams return 403 quota_not_enough with the current balance and required amount in the body.

For more status codes and retry guidance see Error codes and rate limits; for troubleshooting steps on common errors see the FAQ.

GET /v1/tasks/{task_id} 返回任务进度与结果，status 为 completed 时成片地址在 result.videos[0].url，元素带 expires_at 过期时间戳。

建议每 5 到 10 秒轮询一次，客户端总超时设为 10 到 15 分钟。status 取值 pending、processing、completed、failed、cancelled，以状态判定完成，不要依赖 progress。

失败任务自动退回费用，error.message 给出原因。

GET /v1/tasks/{task_id} returns task progress and results; once status is completed, the video URL is at result.videos[0].url, with an expires_at timestamp on the element.

Poll every 5 to 10 seconds, with a 10 to 15 minute client timeout. status is one of pending, processing, completed, failed, cancelled; judge completion by status, not by progress.

Failed tasks are refunded automatically, with the reason in error.message.