Récupérer une vidéo 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
}

Utilisez ce endpoint après avoir créé une tâche vidéo MiniMax H3. La réponse inclut video_url lorsque la tâche est terminée.

Vérifiez ces champs

status peut avoir pour valeur queued, in_progress, completed ou failed.
progress correspond à un pourcentage de progression approximatif allant de 0 à 100.
video_url apparaît lorsque la tâche est terminée.
error apparaît lorsque la tâche échoue.

Interroger la tâche

Créez d’abord la tâche

Commencez par Créer une vidéo MiniMax H3 et stockez la valeur id renvoyée.

Récupérer l’état de la tâche

Envoyez l’ID de tâche à ce endpoint jusqu’à ce que status soit completed ou failed.

Télécharger le fichier MP4

Lorsque status est completed, appelez Télécharger le contenu vidéo MiniMax H3.

Autorisations

Authorization

string

header

requis

Bearer authentication. Use your CometAPI API key.

Paramètres de chemin

task_id

string

requis

Task ID returned by POST /v1/videos.

Réponse

200 - application/json

Current MiniMax H3 video task state.

string

requis

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

Exemple:

"<task_id>"

object

string

requis

Object type for the asynchronous video task.

Allowed value: "video"

model

enum<string>

requis

Model ID that the task uses.

Options disponibles:

minimax-h3,

minimax-h3-max

status

enum<string>

requis

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

Options disponibles:

queued,

in_progress,

completed,

failed

progress

integer

requis

Task progress as a coarse percentage.

Plage requise: 0 <= x <= 100

created_at

integer<int64>

requis

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Exemple:

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

Exemple:

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

error

object

Failure details. This field appears when the task fails.

Show child attributes

Dernière modification le 7 août 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
}

Modération de contenu

Clés API

Vérifiez ces champs

Interroger la tâche

Autorisations

Paramètres de chemin

Réponse

​Vérifiez ces champs

​Interroger la tâche

Autorisations

Paramètres de chemin

Réponse

Vérifiez ces champs

Interroger la tâche