استرجاع فيديو 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
}

استخدم نقطة النهاية هذه لقراءة حالة مهمة تم إنشاؤها من خلال إنشاء فيديو Seedance. تكون قيمة id في المسار هي القيمة التي أعادها استدعاء الإنشاء، بغض النظر عن نموذج Seedance الذي أنتج المهمة. يكون نص الاستجابة هو كائن مهمة الفيديو نفسه. اقرأ status وprogress وvideo_url على المستوى الأعلى.

آلة الحالات

تعيد API سلاسل حالة بأحرف صغيرة. تُعد queued وin_progress حالات غير نهائية؛ أما completed وfailed وerror فهي حالات نهائية ولن تنتقل المهمة بعدها مرة أخرى.

Status	Meaning	Terminal
`queued`	تم قبول المهمة وإدراجها في الطابور للتصيير.	no
`in_progress`	التصيير قيد التنفيذ.	no
`completed`	اكتملت. يكون `video_url` موجودًا في الاستجابة.	yes
`failed`	رفض المزوّد المهمة.	yes
`error`	حال خطأ داخلي دون الإكمال.	yes

وتيرة الاستطلاع

استطلع كل 10 إلى 20 ثانية. تنتهي معظم المهام خلال 1 إلى 3 دقائق بحسب النموذج والمدة والحجم.

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)

الحقول التي يجب مراقبتها

status — يحدد شرط التوقف في حلقة الاستطلاع لديك.
progress — عدد صحيح من 0 إلى 100 يمكنك عرضه في واجهة مستخدم.
video_url — رابط تنزيل موقّع، ويكون موجودًا في استجابات completed. تستخدم تنزيلات Seedance هذا الرابط مباشرة بدلًا من مسار /v1/videos/{id}/content منفصل. يكون التوقيع محدود المدة؛ نزّل الملف أو استضفه مجددًا قبل انتهاء صلاحية التوقيع.
completed_at — طابع زمني Unix اختياري تعيده المنصة. لا تستخدمه لإيقاف الاستطلاع؛ استخدم status بدلًا منه.
model — يعكس model ID الخاص بـ Seedance المستخدم عند إنشاء المهمة.

الأخطاء الشائعة

HTTP 400 مع message: "task_not_exist" يعني أن id غير معروف. تأكد من أنك التقطت id من استجابة POST /v1/videos ناجحة وأنك تستخدمه كما هو حرفيًا.
HTTP 401 يعني أن bearer token مفقود أو غير صالح. تحقق من أن ترويسة الطلب هي Authorization: Bearer $COMETAPI_KEY.

التفويضات

Authorization

string

header

مطلوب

Bearer token authentication. Use your CometAPI key.

معلمات المسار

string

مطلوب

Task id returned by POST /v1/videos.

الاستجابة

Current Seedance video task state.

string

مطلوب

Task id.

object

string

مطلوب

Object type, always video.

model

string

مطلوب

Model id that generated the task.

status

enum<string>

مطلوب

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

الخيارات المتاحة:

queued,

in_progress,

completed,

failed,

error

progress

integer

مطلوب

Completion percentage.

النطاق المطلوب: 0 <= x <= 100

created_at

integer

مطلوب

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.

إنشاء فيديو Seedance

إنشاء فيديو 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
}

الإشراف على المحتوى

مفاتيح API

آلة الحالات

وتيرة الاستطلاع

الحقول التي يجب مراقبتها

الأخطاء الشائعة

التفويضات

معلمات المسار

الاستجابة

​آلة الحالات

​وتيرة الاستطلاع

​الحقول التي يجب مراقبتها

​الأخطاء الشائعة

التفويضات

معلمات المسار

الاستجابة

آلة الحالات

وتيرة الاستطلاع

الحقول التي يجب مراقبتها

الأخطاء الشائعة