Truy xuất video MiniMax H3

GET

videos

{task_id}

cURL

curl "https://api.cometapi.com/v1/videos/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

import os

import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/v1/videos/{task_id}",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"]
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";
const response = await fetch(
  `https://api.cometapi.com/v1/videos/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/videos/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/v1/videos/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/videos/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "minimax-h3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Sử dụng endpoint này sau khi tạo tác vụ video MiniMax H3. Phản hồi bao gồm video_url khi tác vụ hoàn tất.

Kiểm tra các trường này

status có thể là queued, in_progress, completed hoặc failed.
progress là tỷ lệ phần trăm hoàn thành ước tính từ 0 đến 100.
video_url xuất hiện khi tác vụ hoàn tất.
error xuất hiện khi tác vụ thất bại.

Thăm dò tác vụ

Trước tiên, hãy tạo tác vụ

Bắt đầu bằng Tạo video MiniMax H3 và lưu id được trả về.

Truy xuất trạng thái tác vụ

Gửi ID tác vụ đến endpoint này cho đến khi status là completed hoặc failed.

Tải xuống tệp MP4

Khi status là completed, hãy gọi Tải xuống nội dung video MiniMax H3.

Ủy quyền

Authorization

string

header

bắt buộc

Bearer authentication. Use your CometAPI API key.

Tham số đường dẫn

task_id

string

bắt buộc

Task ID returned by POST /v1/videos.

Phản hồi

200 - application/json

Current MiniMax H3 video task state.

string

bắt buộc

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

Ví dụ:

"<task_id>"

object

string

bắt buộc

Object type for the asynchronous video task.

Allowed value: "video"

model

enum<string>

bắt buộc

Model ID that the task uses.

Tùy chọn có sẵn:

minimax-h3,

minimax-h3-max

status

enum<string>

bắt buộc

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

Tùy chọn có sẵn:

queued,

in_progress,

completed,

failed

progress

integer

bắt buộc

Task progress as a coarse percentage.

Phạm vi bắt buộc: 0 <= x <= 100

created_at

integer<int64>

bắt buộc

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Ví dụ:

"<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.

Ví dụ:

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

error

object

Failure details. This field appears when the task fails.

Show child attributes

Lần sửa đổi cuối 7 tháng 8, 2026

cURL

curl "https://api.cometapi.com/v1/videos/<task_id>" \
  -H "Authorization: Bearer $COMETAPI_KEY"

import os

import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/v1/videos/{task_id}",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"]
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";
const response = await fetch(
  `https://api.cometapi.com/v1/videos/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);

if (!response.ok) {
  throw new Error(await response.text());
}

console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/videos/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/v1/videos/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/videos/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "minimax-h3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Kiểm duyệt nội dung

Khóa API

Kiểm tra các trường này

Thăm dò tác vụ

Ủy quyền

Tham số đường dẫn

Phản hồi

​Kiểm tra các trường này

​Thăm dò tác vụ

Ủy quyền

Tham số đường dẫn

Phản hồi

Kiểm tra các trường này

Thăm dò tác vụ