Récupérer une vidéo Flux 3

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": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Utilisez ce point de terminaison après avoir créé une tâche vidéo Flux 3. La réponse inclut video_url lorsque la tâche est terminée.

Vérifiez ces champs

status est queued, in_progress, completed ou failed.
progress est un pourcentage approximatif de réalisation 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 Flux 3 et enregistrez la valeur id renvoyée.

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

Envoyez l’ID de la tâche à ce point de terminaison 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 Flux 3.

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

Current Flux 3 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

string

requis

Model ID that the task uses.

Allowed value: "flux-3"

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>

Task completion time as a Unix timestamp in seconds when the task provides one.

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://media.example.com/flux-3-result.mp4"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Dernière modification le 14 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": "flux-3",
  "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