ByteDance 비디오 생성

bytedance-video 엔드포인트를 사용해 POST /volc/v3/contents/generations/tasks를 통해 유연한 파라미터로 비디오 생성 작업을 생성하고 관리하세요.

POST /volc/v3/contents/generations/tasks

cURL

Text to video

curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'

200

{
  "id": "021773297205999example"
}

이 엔드포인트를 사용하면 텍스트만으로, 또는 텍스트와 참조 이미지를 함께 사용해 ByteDance Seedance 비디오 작업을 시작할 수 있습니다. 요청은 즉시 task id를 반환하며, 렌더링은 비동기적으로 계속 진행됩니다.

​

현재 모델 경로 선택

• 현재 사용 가능한 모델과 식별자는 Models 페이지에서 확인하세요.
• 이 경로의 현재 프로덕션 예시로 doubao-seedance-1-5-pro-251215를 사용하세요.
• 동일한 현재 모델이 통합된 content 배열을 통해 텍스트 전용 요청과 이미지 가이드 요청을 모두 처리할 수 있습니다.

​

작업 흐름

1. content 배열 구성

   기본 텍스트 지시문을 먼저 넣고, 첫 프레임 또는 마지막 프레임 가이드가 필요할 때만 이미지 항목을 추가하세요.

2. 작업 제출

   반환된 task id를 저장하세요. 푸시 전달이 필요하다면 작업 생성 시 callback_url을 설정하세요.

3. 출력이 도착할 때까지 폴링

   작업이 완료되고 content.video_url이 존재할 때까지 ByteDance 비디오 조회를 호출하세요.

​

알려진 래퍼 동작

Volcengine와 Seedance는 이 계열을 생성 후 조회하는 비동기 워크플로로 문서화하고 있습니다. CometAPI는 동일한 작업 패턴을 유지하면서 하나의 기본 URL과 하나의 API 키를 제공합니다.

2026-03-12의 실시간 검증 중 이 경로에는 접근할 수 있었지만, 표준 JSON 샘플에 대해서도 여전히 서버 측 JSON 파싱 오류가 반환되었습니다. 여기의 OpenAPI 예시는 실용적인 래퍼 기준으로 보고, 개발 초기에 payload를 미리 검증하세요.

인증

Authorization · string · header · 필수

Bearer token authentication. Use your CometAPI key.

본문

application/json

model · string · 필수

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

예시:

"doubao-seedance-1-5-pro-251215"

content · object[] · 필수

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

Show child attributes

callback_url · string

Optional webhook URL for task status notifications.

응답

200 - application/json

Task accepted.

id · string · 필수

Task id for later polling.