메인 콘텐츠로 건너뛰기
POST
/
v1
/
videos
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
  -F 'model="doubao-seedance-2-0-fast"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"'
{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-fast",
  "status": "SUBMITTED",
  "progress": 0,
  "created_at": 1776681149
}
이 엔드포인트를 사용해 ByteDance Seedance 비디오 작업을 시작할 수 있습니다. 모든 Seedance 모델 티어는 동일한 요청 형식을 공유하며, model 필드를 설정해 모델을 선택합니다. 호출하면 즉시 task id가 반환되고, 렌더링은 백그라운드에서 계속 진행됩니다.

​
모델 선택

Model idTierNotes
doubao-seedance-2-02.02.0 계열에서 가장 높은 품질의 출력을 제공합니다.
doubao-seedance-2-0-fast2.0빠른 반복 작업과 미리보기를 위한 2.0의 더 빠른 변형입니다.
doubao-seedance-1-5-pro1.5 Pro1080p를 지원합니다. 텍스트-투-비디오 전용입니다.
doubao-seedance-1-0-pro1.0 Pro1080p와 2초부터의 더 짧은 클립을 지원합니다. 텍스트-투-비디오 전용입니다.
실시간 사용 가능 여부는 Models page에서 확인하세요.

​
파라미터 범위

FieldTypeRequiredDefaultAllowed values
promptstringyes—임의의 텍스트
modelstringyes—doubao-seedance-2-0, doubao-seedance-2-0-fast, doubao-seedance-1-5-pro, doubao-seedance-1-0-pro
secondsintegerno5모델에 따라 다름(아래 참조)
sizestringno16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16
resolutionstringno720p2.0 모델은 480p, 720p; 1.5 Pro와 1.0 Pro는 480p, 720p, 1080p
input_referencefileno—JPEG, PNG 또는 WebP. 2.0 모델에서만 허용됩니다.

​
모델별 길이 범위

Modelseconds range
doubao-seedance-2-0, doubao-seedance-2-0-fast4~15
doubao-seedance-1-5-pro4~12
doubao-seedance-1-0-pro2~10
모델 범위를 벗어난 값을 보내면 HTTP 400이 반환되며, code: "InvalidParameter"와 duration에 대한 메시지가 포함됩니다.

​
image-to-video 지원

input_reference 파일은 2.0 모델만 받을 수 있습니다. doubao-seedance-1-5-pro 또는 doubao-seedance-1-0-pro에 input_reference를 보내면 HTTP 400이 반환되며, the specified task_type r2v does not support model seedance-1-5-pro 형태의 메시지가 포함됩니다. 이 모델들은 텍스트-투-비디오 전용으로 사용하세요.

​
참조 이미지 업로드

요청 본문은 multipart/form-data입니다. 2.0 모델에서 image-to-video를 실행하려면 같은 요청에 이미지를 input_reference 파트로 첨부하세요: 
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"' \
  -F 'input_reference=@/path/to/reference.jpg'
/path/to/reference.jpg를 첫 프레임 앵커로 사용할 이미지의 절대 또는 상대 경로로 바꾸세요. 지원 형식은 JPEG, PNG, WebP입니다.

​
작업 흐름

1

작업 제출

최소한 prompt와 model을 포함해 POST 요청을 보내세요. 다음 단계에 사용할 반환된 id를 저장하세요.
2

작업 폴링

10초에서 20초마다 Seedance 비디오 조회를 호출하세요.
3

출력 다운로드

status가 SUCCESS가 되면 video_url의 파일을 다운로드하고, 장기적으로 접근해야 한다면 직접 다시 호스팅하세요. 이 URL은 서명된 URL이며 제한된 시간 후 만료됩니다.

​
오류 응답

이 엔드포인트는 필수 필드가 누락되었거나, 값이 허용 범위를 벗어났거나, image-to-video를 지원하지 않는 모델에 input_reference가 전송된 경우 HTTP 400을 반환합니다. bearer token이 없거나 유효하지 않으면 HTTP 401을 반환합니다. 오류 본문은 두 가지 형식 중 하나를 사용합니다. 정확한 필드는 playground의 400 및 401 예시를 참고하세요.

인증

​
Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

multipart/form-data
​
prompt
string
필수

Text prompt that describes the video. Required.

예시:

"A slow cinematic camera push across a coastal landscape at sunrise."

​
model
enum<string>
필수

Seedance model id. Choose doubao-seedance-2-0 for the highest quality 2.0 output, doubao-seedance-2-0-fast for quick iteration on 2.0, doubao-seedance-1-5-pro for the 1.5 Pro tier, or doubao-seedance-1-0-pro for the 1.0 Pro tier. Only the two 2.0 models accept input_reference.

사용 가능한 옵션:
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-1-5-pro,
doubao-seedance-1-0-pro
예시:

"doubao-seedance-2-0-fast"

​
seconds
integer
기본값:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

필수 범위: 2 <= x <= 15
예시:

5

​
size
enum<string>
기본값:16:9

Output aspect ratio. All Seedance models accept the same set of values.

사용 가능한 옵션:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
예시:

"16:9"

​
resolution
enum<string>
기본값:720p

Output resolution. 480p and 720p are accepted by every model; 1080p is supported only by doubao-seedance-1-5-pro and doubao-seedance-1-0-pro.

사용 가능한 옵션:
480p,
720p,
1080p
예시:

"720p"

​
input_reference
file

Optional reference image. When included, the job runs in image-to-video mode and uses the image as the visual anchor. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

응답

Task created. Save the returned id and poll GET /v1/videos/{id}.

​
id
string
필수

Task id. Use it as the path parameter for GET /v1/videos/{id}.

​
object
string
필수

Object type, always video.

​
model
string
필수

Echo of the requested model id.

​
status
enum<string>
필수

Initial task status. A newly created task is returned as SUBMITTED.

사용 가능한 옵션:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
FAILED,
ERROR
​
progress
integer
필수

Completion percentage. 0 at creation.

필수 범위: 0 <= x <= 100
​
created_at
integer
필수

Task creation time as a Unix timestamp in seconds.

​
task_id
string

Alias of id returned for compatibility. The value matches id.