Récupérer une vidéo Seedance

GET

videos

{id}

cURL

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

import os
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
TERMINAL = {"completed", "failed", "error"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=15,
    )
    response.raise_for_status()
    data = response.json()
    print(data["status"], data.get("progress"))
    if data["status"] in TERMINAL:
        print(data.get("video_url"))
        break
    time.sleep(10)

const TASK_ID = "<TASK_ID>";
const terminal = new Set(["completed", "failed", "error"]);

while (true) {
  const response = await fetch(
    `https://api.cometapi.com/v1/videos/${TASK_ID}`,
    { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
  );
  const data = await response.json();
  console.log(data.status, data.progress);
  if (terminal.has(data.status)) {
    console.log(data.video_url);
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 10_000));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/videos/{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/{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))

}

HttpResponse<String> response = Unirest.get("https://api.cometapi.com/v1/videos/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/videos/{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_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "in_progress",
  "progress": 30,
  "created_at": 1777385418,
  "completed_at": 1777385485
}

Utilisez ce endpoint pour lire l’état d’une tâche créée via Créer une vidéo Seedance. Le id dans le chemin est la valeur renvoyée par l’appel de création, quel que soit le modèle Seedance ayant produit la tâche. Le corps de réponse est l’objet de tâche vidéo lui-même. Lisez status, progress et video_url au niveau supérieur.

Machine d’état

L’API renvoie des chaînes de statut en minuscules. queued et in_progress ne sont pas terminaux ; completed, failed et error sont terminaux et la tâche n’évoluera plus.

Statut	Signification	Terminal
`queued`	Acceptée et mise en file d’attente pour le rendu.	non
`in_progress`	Rendu en cours.	non
`completed`	Terminée. `video_url` est présent dans la réponse.	oui
`failed`	Le fournisseur a rejeté la tâche.	oui
`error`	Une erreur interne a empêché l’achèvement.	oui

Fréquence d’interrogation

Interrogez toutes les 10 à 20 secondes. La plupart des tâches se terminent en 1 à 3 minutes selon le modèle, la durée et la taille.

import os
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
TERMINAL = {"completed", "failed", "error"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=15,
    )
    response.raise_for_status()
    data = response.json()
    if data["status"] in TERMINAL:
        print(data.get("video_url"))
        break
    time.sleep(10)

Champs à surveiller

status — détermine la condition d’arrêt de votre boucle d’interrogation.
progress — entier de 0 à 100 que vous pouvez afficher dans une UI.
video_url — URL de téléchargement signée, présente dans les réponses completed. Les téléchargements Seedance utilisent directement cette URL au lieu d’une route /v1/videos/{id}/content distincte. La signature est limitée dans le temps ; téléchargez ou réhébergez le fichier avant l’expiration de la signature.
completed_at — horodatage Unix facultatif renvoyé par la plateforme. Ne l’utilisez pas pour arrêter l’interrogation ; utilisez status à la place.
model — reprend l’id du modèle Seedance utilisé lors de la création de la tâche.

Erreurs courantes

HTTP 400 avec message: "task_not_exist" signifie que le id est inconnu. Vérifiez que vous avez bien récupéré le id depuis une réponse POST /v1/videos réussie et que vous l’utilisez tel quel.
HTTP 401 signifie que le bearer token est manquant ou invalide. Vérifiez que l’en-tête de requête est Authorization: Bearer $COMETAPI_KEY.

Autorisations

Authorization

string

header

requis

Bearer token authentication. Use your CometAPI key.

Paramètres de chemin

string

requis

Task id returned by POST /v1/videos.

Réponse

Current Seedance video task state.

string

requis

Task id.

object

string

requis

Object type, always video.

model

string

requis

Model id that generated the task.

status

enum<string>

requis

Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.

Options disponibles:

queued,

in_progress,

completed,

failed,

error

progress

integer

requis

Completion percentage.

Plage requise: 0 <= x <= 100

created_at

integer

requis

Task creation time as a Unix timestamp in seconds.

video_url

string | null

Signed download URL for the finished video. Present on completed responses. Seedance downloads use this URL directly instead of a separate /v1/videos/{id}/content route. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.

completed_at

integer | null

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

Créer une vidéo Seedance

Créer une vidéo HappyHorse

cURL

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

import os
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
TERMINAL = {"completed", "failed", "error"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=15,
    )
    response.raise_for_status()
    data = response.json()
    print(data["status"], data.get("progress"))
    if data["status"] in TERMINAL:
        print(data.get("video_url"))
        break
    time.sleep(10)

const TASK_ID = "<TASK_ID>";
const terminal = new Set(["completed", "failed", "error"]);

while (true) {
  const response = await fetch(
    `https://api.cometapi.com/v1/videos/${TASK_ID}`,
    { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
  );
  const data = await response.json();
  console.log(data.status, data.progress);
  if (terminal.has(data.status)) {
    console.log(data.video_url);
    break;
  }
  await new Promise((resolve) => setTimeout(resolve, 10_000));
}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/v1/videos/{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/{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))

}

HttpResponse<String> response = Unirest.get("https://api.cometapi.com/v1/videos/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/v1/videos/{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_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "in_progress",
  "progress": 30,
  "created_at": 1777385418,
  "completed_at": 1777385485
}

Modération de contenu

Clés API

Machine d’état

Fréquence d’interrogation

Champs à surveiller

Erreurs courantes

Autorisations

Paramètres de chemin

Réponse

​Machine d’état

​Fréquence d’interrogation

​Champs à surveiller

​Erreurs courantes

Autorisations

Paramètres de chemin

Réponse

Machine d’état

Fréquence d’interrogation

Champs à surveiller

Erreurs courantes