Bir Seedance videosunu getir

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
}

Bu endpoint’i, Bir Seedance videosu oluşturun üzerinden oluşturulan bir görevin durumunu okumak için kullanın. Yoldaki id, görevi hangi Seedance modelinin ürettiğinden bağımsız olarak create çağrısının döndürdüğü değerdir. Yanıt gövdesi doğrudan video görev nesnesinin kendisidir. Üst düzeydeki status, progress ve video_url alanlarını okuyun.

Durum makinesi

API, küçük harfli durum dizeleri döndürür. queued ve in_progress terminal olmayan durumlardır; completed, failed ve error ise terminal durumlardır ve görev artık ilerlemez.

Status	Anlamı	Terminal
`queued`	Kabul edildi ve render sırasına alındı.	hayır
`in_progress`	Render işlemi sürüyor.	hayır
`completed`	Tamamlandı. Yanıtta `video_url` bulunur.	evet
`failed`	Sağlayıcı görevi reddetti.	evet
`error`	Dahili bir hata tamamlanmayı engelledi.	evet

Sorgulama aralığı

Her 10 ila 20 saniyede bir sorgulayın. Çoğu iş, modele, süreye ve boyuta bağlı olarak 1 ila 3 dakika içinde tamamlanır.

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)

İzlenecek alanlar

status — sorgulama döngünüz için durdurma koşulunu belirler.
progress — bir UI içinde gösterebileceğiniz 0 ile 100 arasında tam sayı.
video_url — imzalı indirme URL’si, completed yanıtlarında bulunur. Seedance indirmeleri, ayrı bir /v1/videos/{id}/content rotası yerine bu URL’yi doğrudan kullanır. İmza süre sınırlıdır; imza süresi dolmadan önce dosyayı indirin veya yeniden barındırın.
completed_at — platform tarafından döndürülen isteğe bağlı Unix zaman damgası. Sorgulamayı durdurmak için bunu kullanmayın; bunun yerine status kullanın.
model — görev oluşturulurken kullanılan Seedance model id değerini yansıtır.

Yaygın hatalar

message: "task_not_exist" ile birlikte HTTP 400, id değerinin bilinmediği anlamına gelir. id değerini başarılı bir POST /v1/videos yanıtından aldığınızı ve aynen kullandığınızı doğrulayın.
HTTP 401, bearer token’ın eksik veya geçersiz olduğu anlamına gelir. İstek başlığının Authorization: Bearer $COMETAPI_KEY olduğundan emin olun.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Yol Parametreleri

string

gerekli

Task id returned by POST /v1/videos.

Yanıt

Current Seedance video task state.

string

gerekli

Task id.

object

string

gerekli

Object type, always video.

model

string

gerekli

Model id that generated the task.

status

enum<string>

gerekli

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

Mevcut seçenekler:

queued,

in_progress,

completed,

failed,

error

progress

integer

gerekli

Completion percentage.

Gerekli aralık: 0 <= x <= 100

created_at

integer

gerekli

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.

Bir Seedance videosu oluşturun

Bir HappyHorse videosu oluşturun

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
}

İçerik moderasyonu

API anahtarları

Durum makinesi

Sorgulama aralığı

İzlenecek alanlar

Yaygın hatalar

Yetkilendirmeler

Yol Parametreleri

Yanıt

​Durum makinesi

​Sorgulama aralığı

​İzlenecek alanlar

​Yaygın hatalar

Yetkilendirmeler

Yol Parametreleri

Yanıt

Durum makinesi

Sorgulama aralığı

İzlenecek alanlar

Yaygın hatalar