Ana içeriğe atla
GET
/
v1
/
videos
/
{id}
cURL
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer <COMETAPI_KEY>"
{ "id": "task_abc123", "model": "doubao-seedance-2-0-fast", "object": "video", "status": "IN_PROGRESS", "progress": 45, "created_at": 1776567610, "completed_at": null }
Create a Seedance video üzerinden oluşturulmuş bir görevin durumunu okumak için bu endpoint’i kullanın. Yoldaki id, görevi hangi Seedance modelinin oluşturduğundan bağımsız olarak create çağrısının döndürdüğü değerdir.

​
Durum makinesi

Görev aşağıdaki durumlardan birinden geçer. SUBMITTED ve IN_PROGRESS terminal olmayan durumlardır; SUCCESS, FAILED ve ERROR terminal durumlardır ve görev artık başka bir duruma geçmez.
StatusAnlamıTerminal
SUBMITTEDKabul edildi ve render kuyruğuna alındı.hayır
IN_PROGRESSRender işlemi sürüyor.hayır
SUCCESSTamamlandı. Yanıtta video_url bulunur.evet
FAILEDSağlayıcı görevi reddetti.evet
ERRORDahili bir hata tamamlanmayı engelledi.evet

​
Sorgulama aralığı

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

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer <COMETAPI_KEY>"}
TERMINAL = {"SUCCESS", "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)

​
İzlenmesi gereken alanlar

  • status — sorgulama döngünüz için durdurma koşulunu belirler.
  • progress — bir kullanıcı arayüzünde gösterebileceğiniz 0 ile 100 arasında tam sayı.
  • video_url — imzalı indirme URL’si, yalnızca SUCCESS durumunda bulunur. İmza süreyle sınırlıdır; imza süresi dolmadan önce dosyayı indirin veya yeniden barındırın.
  • completed_at — görev terminal bir duruma ulaştığında doldurulan Unix zaman damgası.
  • model — görev oluşturulurken kullanılan Seedance model id değerini yansıtır.

​
Yaygın hatalar

  • HTTP 400 ve message: "task_not_exist" değeri, 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

​
id
string
gerekli

Task id returned by POST /v1/videos.

Yanıt

Current task state.

​
id
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. SUBMITTED and IN_PROGRESS are non-terminal. SUCCESS, FAILED, and ERROR are terminal.

Mevcut seçenekler:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
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 only when status is SUCCESS. 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

Task completion time as a Unix timestamp in seconds. null while the task is non-terminal.