Skip to main content
GET
cURL
创建 MiniMax H3 视频任务后,使用此端点。任务完成后,响应中会包含 video_url

检查以下字段

  • status 的值为 queuedin_progresscompletedfailed
  • progress 是从 0100 的粗略完成百分比。
  • video_url 在任务完成时出现。
  • error 在任务失败时出现。

轮询任务

1

先创建任务

创建 MiniMax H3 视频 ,并存储返回的 id
2

检索任务状态

将任务 ID 发送到此端点,直到 statuscompletedfailed
3

下载 MP4 文件

statuscompleted 时,调用 下载 MiniMax H3 视频内容.

授权

Authorization
string
header
必填

Bearer authentication. Use your CometAPI API key.

路径参数

task_id
string
必填

Task ID returned by POST /v1/videos.

响应

200 - application/json

Current MiniMax H3 video task state.

id
string
必填

Task ID. Use this value as task_id in retrieve and content requests.

示例:

"<task_id>"

object
string
必填

Object type for the asynchronous video task.

Allowed value: "video"
model
enum<string>
必填

Model ID that the task uses.

可用选项:
minimax-h3,
minimax-h3-max
status
enum<string>
必填

Task lifecycle status. Poll until the value is completed or failed.

可用选项:
queued,
in_progress,
completed,
failed
progress
integer
必填

Task progress as a coarse percentage.

必填范围: 0 <= x <= 100
created_at
integer<int64>
必填

Task creation time as a Unix timestamp in seconds.

task_id
string

Compatibility alias for id. This field can be omitted from retrieve responses.

示例:

"<task_id>"

completed_at
integer<int64>

Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.

expires_at
integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url
string<uri>

Video delivery URL. This field appears on completed tasks.

示例:

"https://<provider-cdn>/<video_id>.mp4"

error
object

Failure details. This field appears when the task fails.

最后修改于 2026年8月7日