curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-draft-to-video",
  "source_task_id": "task-unified-1774857405-abc123"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-draft-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 0
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

Seedance 2.5

Seedance 2.5 Draft-to-Video 초안을 최종 비디오로 변환

완료된 Seedance 2.5 초안(생성 시 draft: true를 전달한 작업)을 동일한 내용의 1080p 최종 비디오로 변환합니다
model, source_task_id, output_format, callback_url의 네 필드만 허용됩니다. 프롬프트, 소재, 길이, 화면 비율, 랜덤 시드, 오디오 설정은 모두 초안에서 이어받습니다. 다시 전달할 필요가 없으며, 전달해서도 안 됩니다. 이 외의 필드를 전달하면 400 파라미터 오류가 반환됩니다
초안의 draft_expires_at 이전에 변환 요청을 제출하세요. 기본 유효기간은 초안 완료 후 24시간이며, 실제 기한은 작업 조회에서 반환되는 draft_expires_at을 기준으로 합니다
시스템은 요청을 접수할 때와 생성 요청을 전송하기 전에 유효기간을 확인합니다. 대기 중에 유효기간이 만료되면 변환 작업이 실패하고 해당 변환 요금이 환불되므로, 대기 시간을 고려하여 여유 있게 제출하세요
유효기간 내에는 같은 초안을 여러 번 변환할 수 있으며, 변환할 때마다 별도로 과금됩니다
비동기 처리 방식으로, 반환된 작업 ID로 조회하세요. 조회 결과에는 source_task_id가 포함됩니다
생성된 비디오 링크의 유효기간은 24시간입니다. 가능한 빨리 저장하세요

과금 규칙:

초안과 별도로 과금되며, 해상도는 항상 1080p로 계산됩니다
출력 길이는 원본 초안에 기록된 실제 생성 길이를 사용합니다. 실제 값이 없으면 원본 작업에 기록된 유효 출력 길이를 사용합니다
과금 대상 길이: 초안에 비디오 입력이 없으면 출력 길이, 비디오 입력이 있으면(Reference-to-Video, Video Edit, Video Extend 포함) 출력 길이 + max(입력 비디오 길이, 출력 길이)입니다. 두 경우 모두 0.1초 단위로 올림합니다
초안에서 콘텐츠 필터를 비활성화한 경우(content_filter: false), 최종 비디오에도 +10%(1.1x) 요금이 적용됩니다
변환에 실패하면 해당 변환 요금은 환불되지만, 초안 요금은 환불되지 않습니다

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5-draft-to-video",
  "source_task_id": "task-unified-1774857405-abc123"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "seedance-2.5-draft-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 0
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "user_group": "default"
  }
}

인증

Authorization

string

header

필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 얻기:

API Key 관리 페이지에서 API Key를 받으세요

요청 헤더에 다음을 추가하세요:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

기본값:seedance-2.5-draft-to-video

필수

비디오 생성 모델 이름

사용 가능한 옵션:

seedance-2.5-draft-to-video

예시:

"seedance-2.5-draft-to-video"

source_task_id

string

필수

완료된 Seedance 2.5 초안 작업의 Task ID

확인 방법: 초안 생성 요청(draft: true)의 응답에서 반환된 id 필드

조건:

작업이 현재 계정에 속해야 합니다
작업 모델이 Seedance 2.5의 다섯 가지 생성 모델 중 하나여야 합니다
작업 생성 시 draft: true를 전달했어야 합니다
작업 상태가 completed여야 합니다
현재 시각이 작업 조회 결과의 draft_expires_at보다 이전이어야 합니다

예시:

"task-unified-1774857405-abc123"

output_format

enum<string>

기본값:mp4

출력 컨테이너 형식, 기본값은 mp4

선택 가능한 값:

mp4: 기본 컨테이너 형식입니다. 이 엔드포인트는 10비트 색 심도와 H.265/HEVC 인코딩을 사용하는 1080p 동영상을 출력합니다. 재생 환경이 10비트 HEVC를 지원해야 하며, H.264만 지원하는 플레이어에서는 재생되지 않을 수 있습니다
mov: H.264 + yuv444p 크로마 서브샘플링 + PCM 오디오로 색 재현력이 높아 색보정·키잉·합성 등 후반 작업에 적합합니다. 브라우저 내 재생이 지원되지 않을 수 있으므로 다운로드 후 VLC / mpv / ffplay로 재생하세요. 추가 요금 없음

초안의 출력 형식은 이어받지 않습니다. mov가 필요하면 여기에서 지정하세요

사용 가능한 옵션:

mp4,

mov

예시:

"mp4"

callback_url

string<uri>

작업 완료 후 HTTPS 콜백 주소

콜백 시점:

작업 완료(completed) 또는 실패(failed) 시 트리거
과금 확인 완료 후 전송

보안 제한:

HTTPS 프로토콜만 지원
내부 네트워크 IP 주소로의 콜백 금지(127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
URL 길이는 2048자를 초과할 수 없습니다

콜백 메커니즘:

타임아웃: 10초
실패 시 최대 3회 재시도(실패 후 각각 1/2/4초 후 재시도)
콜백 응답 본문 형식은 작업 조회 API 반환 형식과 동일
2xx 상태 코드를 성공으로 간주하며, 다른 상태 코드는 재시도를 트리거합니다

예시:

"https://your-domain.com/webhooks/video-task-completed"

응답

최종 비디오 변환 작업 생성 성공

created

integer

작업 생성 타임스탬프

예시:

1761313744

string

작업 ID

예시:

"task-unified-1774857405-abc123"

model

string

실제 사용된 모델 이름

예시:

"seedance-2.5-draft-to-video"

object

enum<string>

작업의 구체적 유형

사용 가능한 옵션:

video.generation.task

progress

integer

작업 진행률 (0-100)

필수 범위: 0 <= x <= 100

예시:

0

status

enum<string>

작업 상태

사용 가능한 옵션:

pending,

processing,

completed,

failed

예시:

"pending"

task_info

object

비디오 작업 상세 정보

Show child attributes

type

enum<string>

작업의 출력 유형

사용 가능한 옵션:

text,

image,

audio,

video

예시:

"video"

usage

object

사용량 및 과금 정보

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Seedance 2.5 Draft-to-Video 초안을 최종 비디오로 변환

인증

본문

응답