Ana içeriğe atla
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
Bu endpoint’i, bir ByteDance Jimeng görevi oluşturduktan sonra kullanın. Render başlatmaz. Yalnızca mevcut görev durumunu ve iş tamamlandığında oluşturulan video URL’sini ve çıktı metadatasını bildirir.

Bu alanlara dikkat edin

  • mevcut sağlayıcı durumu için status
  • render tamamlandığında content.video_url
  • uygulamanız çıktı metadatasına ihtiyaç duyuyorsa resolution, duration, ratio ve framespersecond

Polling döngüsü

1

Önce bir görev oluşturun

2

Görev id ile polling yapın

Durum terminal bir duruma ulaşana kadar bu endpoint’i çağırmaya devam edin.
3

Sonucu kalıcı olarak saklayın

content.video_url göründüğünde, uzun süreli saklama ihtiyacınız varsa sonucu kendi depolamanıza kopyalayın.

Sonuç URL’leri

ByteDance iş akışı hâlâ önce oluşturma, ardından görev id ile sorgulama şeklindedir. CometAPI bu yapıyı korur ve kimlik doğrulamayı normalize eder. Döndürülen video URL’sini kalıcı depolama değil, bir teslim URL’si olarak değerlendirin.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Yol Parametreleri

id
string
gerekli

Task id returned by the create endpoint.

Yanıt

200 - application/json

Current task state.

id
string
gerekli
model
string
gerekli
status
string
gerekli

Provider task status.

created_at
integer
gerekli
updated_at
integer
gerekli
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer