Mengambil video 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
}

Gunakan endpoint ini untuk membaca status tugas yang dibuat melalui Membuat video Seedance. id di path adalah nilai yang dikembalikan oleh pemanggilan create, terlepas dari model Seedance mana yang menghasilkan tugas tersebut. Body respons adalah objek tugas video itu sendiri. Baca status, progress, dan video_url di level teratas.

Mesin status

API mengembalikan string status huruf kecil. queued dan in_progress bersifat non-terminal; completed, failed, dan error bersifat terminal dan tugas tidak akan berubah lagi.

Status	Arti	Terminal
`queued`	Diterima dan dimasukkan ke antrean untuk rendering.	tidak
`in_progress`	Rendering sedang berlangsung.	tidak
`completed`	Selesai. `video_url` ada di respons.	ya
`failed`	Penyedia menolak tugas tersebut.	ya
`error`	Kesalahan internal mencegah penyelesaian.	ya

Kadens polling

Lakukan polling setiap 10 hingga 20 detik. Sebagian besar pekerjaan selesai dalam 1 hingga 3 menit tergantung pada model, durasi, dan ukuran.

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)

Field yang perlu dipantau

status — menentukan kondisi berhenti untuk loop polling Anda.
progress — bilangan bulat 0 hingga 100 yang dapat Anda tampilkan di UI.
video_url — URL unduhan bertanda tangan, ada pada respons completed. Unduhan Seedance menggunakan URL ini secara langsung alih-alih route /v1/videos/{id}/content yang terpisah. Tanda tangannya dibatasi waktu; unduh atau host ulang file sebelum tanda tangan kedaluwarsa.
completed_at — stempel waktu Unix opsional yang dikembalikan oleh platform. Jangan gunakan ini untuk menghentikan polling; gunakan status sebagai gantinya.
model — mengembalikan model ID Seedance yang digunakan saat tugas dibuat.

Kesalahan umum

HTTP 400 dengan message: "task_not_exist" berarti id tidak dikenal. Pastikan Anda mengambil id dari respons POST /v1/videos yang berhasil dan menggunakannya apa adanya.
HTTP 401 berarti bearer token tidak ada atau tidak valid. Periksa bahwa header permintaan adalah Authorization: Bearer $COMETAPI_KEY.

Otorisasi

Authorization

string

header

wajib

Bearer token authentication. Use your CometAPI key.

Parameter Path

string

wajib

Task id returned by POST /v1/videos.

Respons

Current Seedance video task state.

string

wajib

Task id.

object

string

wajib

Object type, always video.

model

string

wajib

Model id that generated the task.

status

enum<string>

wajib

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

Opsi yang tersedia:

queued,

in_progress,

completed,

failed,

error

progress

integer

wajib

Completion percentage.

Rentang yang diperlukan: 0 <= x <= 100

created_at

integer

wajib

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.

Buat video Seedance

Sebelumnya

Membuat video HappyHorse

Selanjutnya

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
}

Moderasi konten

Kunci API

Mesin status

Kadens polling

Field yang perlu dipantau

Kesalahan umum

Otorisasi

Parameter Path

Respons

​Mesin status

​Kadens polling

​Field yang perlu dipantau

​Kesalahan umum

Otorisasi

Parameter Path

Respons

Mesin status

Kadens polling

Field yang perlu dipantau

Kesalahan umum