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
/
v1
/
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"
}
}인증
##모든 API는 Bearer Token 인증이 필요합니다##
API Key 얻기:
API Key 관리 페이지에서 API Key를 받으세요
요청 헤더에 다음을 추가하세요:
Authorization: Bearer YOUR_API_KEY
본문
application/json
비디오 생성 모델 이름
사용 가능한 옵션:
seedance-2.5-draft-to-video 예시:
"seedance-2.5-draft-to-video"
완료된 Seedance 2.5 초안 작업의 Task ID
확인 방법: 초안 생성 요청(draft: true)의 응답에서 반환된 id 필드
조건:
- 작업이 현재 계정에 속해야 합니다
- 작업 모델이 Seedance 2.5의 다섯 가지 생성 모델 중 하나여야 합니다
- 작업 생성 시
draft: true를 전달했어야 합니다 - 작업 상태가
completed여야 합니다 - 현재 시각이 작업 조회 결과의
draft_expires_at보다 이전이어야 합니다
예시:
"task-unified-1774857405-abc123"
출력 컨테이너 형식, 기본값은 mp4
선택 가능한 값:
mp4: H.264 인코딩으로 호환성이 가장 좋고 표준 색상 정밀도를 제공하며, 기본값입니다mov: H.264 + yuv444p 크로마 서브샘플링 + PCM 오디오로 색 재현력이 높아 색보정·키잉·합성 등 후반 작업에 적합합니다. 브라우저 내 재생이 지원되지 않을 수 있으므로 다운로드 후 VLC / mpv / ffplay로 재생하세요. 추가 요금 없음
초안의 출력 형식은 이어받지 않습니다. mov가 필요하면 여기에서 지정하세요
사용 가능한 옵션:
mp4, mov 예시:
"mp4"
작업 완료 후 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"
응답
최종 비디오 변환 작업 생성 성공
작업 생성 타임스탬프
예시:
1761313744
작업 ID
예시:
"task-unified-1774857405-abc123"
실제 사용된 모델 이름
예시:
"seedance-2.5-draft-to-video"
작업의 구체적 유형
사용 가능한 옵션:
video.generation.task 작업 진행률 (0-100)
필수 범위:
0 <= x <= 100예시:
0
작업 상태
사용 가능한 옵션:
pending, processing, completed, failed 예시:
"pending"
비디오 작업 상세 정보
Show child attributes
Show child attributes
작업의 출력 유형
사용 가능한 옵션:
text, image, audio, video 예시:
"video"
사용량 및 과금 정보
Show child attributes
Show child attributes