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-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

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

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "draft_unavailable",
    "message": "Draft mode is not available on the selected service right now. Retry later or send the request without draft.",
    "type": "invalid_request_error"
  }
}

Seedance 2.5

Seedance 2.5 전체 파라미터 가이드

Seedance 2.5 통합 파라미터 문서입니다. model로 이 폴더의 모델을 선택합니다. 필수 필드, 입력 조건, 요금 규칙은 모드별로 설명합니다.

모델 ID	모드	필수 필드(model 제외)
`seedance-2.5-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.5-reference-to-video`	Reference-to-Video	`prompt`
`seedance-2.5-video-edit`	Video Edit	`prompt`, `video_urls`
`seedance-2.5-video-extend`	Video Extend	`prompt`, `video_urls`
`seedance-2.5-draft-to-video`	Draft-to-Video	`source_task_id`

Text-to-Video

순수 텍스트 프롬프트로 비디오를 생성하며, 웹 검색을 통한 시의성 강화를 지원합니다
AIGC 유형 실사 소재 지원
초안 모드 지원: draft: true를 전달하면 먼저 480p 초안 비디오를 생성합니다. 결과를 확인한 후 Draft-to-Video로 1080p 최종 비디오로 변환할 수 있으며, 두 작업은 별도로 과금됩니다
비동기 처리 모드로, 반환된 작업 ID를 사용하여 조회하세요
생성된 비디오 링크는 24시간 동안 유효하며, 가능한 빨리 저장하세요

Image-to-Video

이미지 1장을 입력하면 첫 프레임 비디오를 생성하고, 이미지 2장을 입력하면 첫/끝 프레임 비디오를 생성하며, 모델이 자동으로 판단합니다
AIGC 유형 실사 소재 지원
초안 모드 지원: draft: true를 전달하면 먼저 480p 초안 비디오를 생성합니다. 결과를 확인한 후 Draft-to-Video로 1080p 최종 비디오로 변환할 수 있으며, 두 작업은 별도로 과금됩니다
비동기 처리 모드로, 반환된 작업 ID를 사용하여 조회하세요
생성된 비디오 링크는 24시간 동안 유효하며, 가능한 빨리 저장하세요

Reference-to-Video

참조 이미지(0~~30장) + 참조 비디오(0~~10개) + 참조 오디오(0~10개) + 텍스트 프롬프트로 비디오를 생성하며, 이미지·비디오·오디오 중 하나 이상을 제공해야 합니다
새로운 영상 생성에 적합합니다: 이미지·비디오·오디오를 스타일, 주체, 카메라 워크, 배경음악 참조로 사용합니다
기존 비디오를 수정하거나 이어서 만들려면 Video Edit / Video Extend를 사용하세요: 이 모델의 프롬프트에 편집·연장 의도가 담기면 편집 / 연장 작업 기준으로 파라미터가 검증되므로, 제출 시에는 오류가 없고 작업이 실행되는 중에 실패합니다
AIGC 유형 실사 소재 지원
초안 모드 지원: draft: true를 전달하면 먼저 480p 초안 비디오를 생성합니다. 결과를 확인한 후 Draft-to-Video로 1080p 최종 비디오로 변환할 수 있으며, 두 작업은 별도로 과금됩니다
비동기 처리 모드로, 반환된 작업 ID를 사용하여 조회하세요
생성된 비디오 링크는 24시간 동안 유효하며, 가능한 빨리 저장하세요

Video Edit

입력 비디오를 편집 — 피사체 교체, 객체 추가·삭제, 부분 리페인팅 또는 스타일 변경
프롬프트에 편집 의도를 명시해야 합니다(예: “비디오 편집: @video1의 배경 음악 제거”)
편집할 비디오(필수) + 선택 참조 이미지(0–30) + 참조 비디오(총 최대 10개) + 참조 오디오(0–10) 입력
AIGC 유형 실사 소재 지원
초안 모드 지원: draft: true를 전달하면 먼저 480p 초안 비디오를 생성합니다. 결과를 확인한 후 Draft-to-Video로 1080p 최종 비디오로 변환할 수 있으며, 두 작업은 별도로 과금됩니다
비동기 처리 모드로, 반환된 작업 ID를 사용하여 조회하세요
생성된 비디오 링크는 24시간 동안 유효하며, 가능한 빨리 저장하세요

Video Extend

입력 비디오를 앞이나 뒤로 연장
프롬프트에 연장 의도를 명시해야 합니다(예: “@video1을 뒤로 연장, 인물이 화면 밖으로 걸어 나감”)
연장할 비디오(필수) + 선택 참조 이미지(0–30) + 참조 비디오(총 최대 10개) + 참조 오디오(0–10) 입력
AIGC 유형 실사 소재 지원
초안 모드 지원: draft: true를 전달하면 먼저 480p 초안 비디오를 생성합니다. 결과를 확인한 후 Draft-to-Video로 1080p 최종 비디오로 변환할 수 있으며, 두 작업은 별도로 과금됩니다
비동기 처리 모드로, 반환된 작업 ID를 사용하여 조회하세요
생성된 비디오 링크는 24시간 동안 유효하며, 가능한 빨리 저장하세요

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-text-to-video",
  "prompt": "A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically.",
  "duration": 8,
  "quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "content_filter": true
}
'

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

{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: seedance-2.5-text-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "draft_unavailable",
    "message": "Draft mode is not available on the selected service right now. Retry later or send the request without draft.",
    "type": "invalid_request_error"
  }
}

인증

Authorization

string

header

필수

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

API Key 얻기:

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

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

Authorization: Bearer YOUR_API_KEY

본문

application/json

이 페이지는 각 모드의 파라미터를 통합합니다. 필수 여부, 허용 값, 기본값은 선택한 model에 따라 달라지며 아래에 모드별 차이를 설명합니다.

model

enum<string>

필수

비디오 생성 모델 이름

모델 ID	모드	필수 필드(model 제외)
`seedance-2.5-text-to-video`	Text-to-Video	`prompt`
`seedance-2.5-image-to-video`	Image-to-Video	`prompt`, `image_urls`
`seedance-2.5-reference-to-video`	Reference-to-Video	`prompt`
`seedance-2.5-video-edit`	Video Edit	`prompt`, `video_urls`
`seedance-2.5-video-extend`	Video Extend	`prompt`, `video_urls`
`seedance-2.5-draft-to-video`	Draft-to-Video	`source_task_id`

사용 가능한 옵션:

seedance-2.5-text-to-video,

seedance-2.5-image-to-video,

seedance-2.5-reference-to-video,

seedance-2.5-video-edit,

seedance-2.5-video-extend,

seedance-2.5-draft-to-video

예시:

"seedance-2.5-text-to-video"

prompt

string

지원 모드: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video

생성할 비디오를 설명하는 텍스트 프롬프트. 중국어와 영어를 지원하며, 중국어는 500자 이내, 영어는 1000단어 이내를 권장합니다. 프롬프트 최대 길이: 10000 tokens

주의:

이 모델은 순수 텍스트-비디오 모델로, image_urls, video_urls, audio_urls 입력을 지원하지 않습니다

Image-to-Video

주의:

이 모델은 video_urls, audio_urls 입력을 지원하지 않습니다

Reference-to-Video

생성할 비디오를 설명하는 텍스트 프롬프트. 중국어와 영어를 지원하며, 중국어는 500자 이내를 권장합니다. 프롬프트 최대 길이: 10000 tokens

설명:

prompt에서 입력 소재를 참조할 때는 「이미지 1」, 「비디오 1」, 「오디오 1」과 같은 자연어 표현에만 의존하지 말고 @image1, @video1, @audio1과 같은 명시적 태그를 우선 사용하세요
태그 번호는 해당 URL 배열의 순서를 따르며 1부터 시작합니다. image_urls의 첫 번째 항목은 @image1, video_urls의 첫 번째 항목은 @video1, audio_urls의 첫 번째 항목은 @audio1입니다
자연어 번호도 인식될 수 있지만, 명시적 태그를 사용하면 각 소재와 용도를 더 명확하게 연결할 수 있습니다

편집 / 연장 작업으로 판정되지 않도록 주의:

작업 유형은 프롬프트 의도로 판정됩니다. "비디오 편집", "추가", "삭제 / 제거", "수정 / 교체" 같은 표현은 비디오 편집으로, "앞 / 뒤로 연장", "이어서 쓰기" 같은 표현은 비디오 연장으로 판정됩니다
이 두 작업으로 판정되면 aspect_ratio는 adaptive여야 하고, 비디오 편집의 duration은 -1이어야 합니다. 그렇지 않으면 제출 시에는 오류가 없고 이후 작업이 failed(오류 코드 InvalidParameter.TaskTypeConstraint)로 끝납니다. 선차감된 크레딧은 환불되지만 기다린 시간은 낭비됩니다
실제로 편집 / 연장이 필요하다면 seedance-2.5-video-edit, seedance-2.5-video-extend를 바로 사용하세요. 제출 시점에 파라미터를 검증하므로 잘못된 값은 즉시 동기 오류로 반환됩니다
참조 생성만 할 때는 "교체", "제거" 같은 단어를 "화면에 … 가 등장한다", "@image1 의 스타일로 표현한다"처럼 묘사적인 표현으로 바꾸세요

Video Edit

원하는 편집 결과를 설명하는 텍스트 프롬프트입니다. 한국어·중국어·영어를 지원하며 500자 이내를 권장합니다. 프롬프트 최대 길이: 10000 tokens

설명:

프롬프트에 편집 의도를 명시해야 합니다. 예: "비디오 편집: @video1의 배경 음악 제거"
각 소재의 용도는 자연어로 지정할 수 있습니다. 예: "@video1의 인물을 @image1의 인물로 교체"
모델이 소재 번호와 용도의 대응 관계를 자동으로 이해합니다

Video Extend

원하는 연장 결과를 설명하는 텍스트 프롬프트입니다. 한국어·중국어·영어를 지원하며 500자 이내를 권장합니다. 프롬프트 최대 길이: 10000 tokens

설명:

프롬프트에 연장 의도를 명시해야 합니다. 예: "@video1을 뒤로 연장, 인물이 화면 밖으로 걸어 나감"
각 소재의 용도는 자연어로 지정할 수 있습니다. 예: "@image1의 스타일로 @video1을 앞으로 연장"
모델이 소재 번호와 용도의 대응 관계를 자동으로 이해합니다

예시:

"A macro lens focuses on a green glass frog on a leaf. The focus gradually shifts from its smooth skin to its completely transparent abdomen, where a bright red heart is beating powerfully and rhythmically."

source_task_id

string

지원 모드: Draft-to-Video

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

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

조건:

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

예시:

"task-unified-1774857405-abc123"

image_urls

string<uri>[]

지원 모드: Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Image-to-Video

이미지 URL 배열, 1~2장

이미지 수량 및 동작:

이미지 수량	동작	역할
1장	첫 프레임 이미지-비디오	자동으로 `first_frame` 설정
2장	첫/끝 프레임 이미지-비디오	1번째 → `first_frame`, 2번째 → `last_frame`

이미지 요구사항:

지원 형식: .jpeg, .png, .webp
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
단일 파일 크기: 30MB 이하
요청 본문 총 크기 64MB 이하
첫/끝 프레임 입력 시 두 이미지가 동일할 수 있습니다. 화면 비율이 다를 경우 첫 프레임을 기준으로 하며, 끝 프레임은 자동으로 크롭하여 맞춥니다
이미지 URL은 서버에서 직접 접근 가능해야 합니다

Reference-to-Video

참조 이미지 URL 배열, 선택 사항이며 제공 시 1~30장

필수 조건: image_urls, video_urls, audio_urls 중 하나 이상을 제공해야 합니다.

역할 설명:

미디어 유형	역할	일반적인 용도
이미지	`reference_image`	스타일 참조, 제품 이미지, 첫/끝 프레임(prompt로 지정)

이미지 요구사항:

지원 형식: .jpeg, .png, .webp
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
단일 파일 크기: 30MB 이하
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
이미지 URL은 서버에서 직접 접근 가능해야 합니다

Video Edit

참조 이미지 URL 배열, 선택 사항이며 제공 시 1~30장

필수 조건: 이 모델은 video_urls가 필수이며, 이미지는 선택적인 보조 참조 소재입니다.

역할 설명:

미디어 유형	역할	일반적인 용도
이미지	`reference_image`	스타일 참조, 제품 이미지, 교체할 피사체(prompt로 지정)

이미지 요구사항:

지원 형식: .jpeg, .png, .webp
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
단일 파일 크기: 30MB 이하
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
이미지 URL은 서버에서 직접 접근 가능해야 합니다

Video Extend

참조 이미지 URL 배열, 선택 사항이며 제공 시 1~30장

필수 조건: 이 모델은 video_urls가 필수이며, 이미지는 선택적인 보조 참조 소재입니다.

역할 설명:

미디어 유형	역할	일반적인 용도
이미지	`reference_image`	스타일 참조, 제품 이미지, 장면 참조(prompt로 지정)

이미지 요구사항:

지원 형식: .jpeg, .png, .webp
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
단일 파일 크기: 30MB 이하
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
이미지 URL은 서버에서 직접 접근 가능해야 합니다

Required array length: 1 - 30 elements

예시:

["https://example.com/first-frame.jpg"]

video_urls

string<uri>[]

지원 모드: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

참조 비디오 URL 배열, 선택 사항이며 제공 시 1~10개

필수 조건: image_urls, video_urls, audio_urls 중 하나 이상을 제공해야 합니다.

역할 설명:

미디어 유형	역할	일반적인 용도
비디오	`reference_video`	카메라 워크 참조, 동작 참조, 편집/연장할 원본 비디오

비디오 요구사항:

지원 형식: .mp4, .mov
해상도: 480p, 720p, 1080p, 4K
단일 비디오 길이: 2 ~ 30초, 최대 10개, 모든 비디오 총 길이 <= 30초
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
화면 픽셀(너비 x 높이): 409,600 ~ 8,295,044(예: 640x640 ~ 3326x2494)
단일 파일 크기: 200MB 이하
프레임 레이트: 24 ~ 60 FPS
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
코덱, 해상도 등 소재의 유효성은 모델에서 추가로 확인됩니다
비디오 참조 사용 시 추가 비용이 발생합니다(입력 비디오 길이가 과금에 포함)
비디오 URL은 서버에서 직접 접근 가능해야 합니다

Video Edit

입력 비디오 URL 배열, 필수; 1–10개

필수 조건: 편집할 비디오를 최소 1개 제공해야 합니다. 첫 번째 비디오가 편집 대상이고 나머지는 참조 소재로 사용됩니다.

역할 설명:

미디어 유형	역할	일반적인 용도
비디오	`reference_video`	편집할 비디오(첫 번째), 카메라 무빙·동작 참조(나머지)

비디오 요구사항:

지원 형식: .mp4, .mov
해상도: 480p, 720p, 1080p, 4K
단일 비디오 길이: 4 ~ 30초(첫 번째 비디오가 편집 대상), 최대 10개, 모든 비디오 총 길이 <= 30초
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
화면 픽셀(너비 x 높이): 409,600 ~ 8,295,044(예: 640x640 ~ 3326x2494)
단일 파일 크기: 200MB 이하
프레임 레이트: 24 ~ 60 FPS
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
코덱, 해상도 등 소재의 유효성은 모델에서 추가로 확인됩니다
비디오 참조 사용 시 추가 비용이 발생합니다(입력 비디오 길이가 과금에 포함)
비디오 URL은 서버에서 직접 접근 가능해야 합니다

Video Extend

입력 비디오 URL 배열, 필수; 1–10개

필수 조건: 연장할 비디오를 최소 1개 제공해야 합니다. 첫 번째 비디오가 연장 대상이고 나머지는 참조 소재로 사용됩니다.

역할 설명:

미디어 유형	역할	일반적인 용도
비디오	`reference_video`	연장할 비디오(첫 번째), 카메라 무빙·동작 참조(나머지)

비디오 요구사항:

지원 형식: .mp4, .mov
해상도: 480p, 720p, 1080p, 4K
단일 비디오 길이: 2 ~ 30초, 최대 10개, 모든 비디오 총 길이 <= 30초
화면 비율(너비/높이): 0.4 ~ 2.5
너비/높이 픽셀: 300 ~ 6000 px
화면 픽셀(너비 x 높이): 409,600 ~ 8,295,044(예: 640x640 ~ 3326x2494)
단일 파일 크기: 200MB 이하
프레임 레이트: 24 ~ 60 FPS
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
코덱, 해상도 등 소재의 유효성은 모델에서 추가로 확인됩니다
비디오 참조 사용 시 추가 비용이 발생합니다(입력 비디오 길이가 과금에 포함)
비디오 URL은 서버에서 직접 접근 가능해야 합니다

Required array length: 1 - 10 elements

예시:

["https://example.com/reference.mp4"]

audio_urls

string<uri>[]

지원 모드: Reference-to-Video, Video Edit, Video Extend

Reference-to-Video

참조 오디오 URL 배열, 선택 사항이며 제공 시 1~10개

필수 조건: image_urls, video_urls, audio_urls 중 하나 이상을 제공해야 합니다.

역할 설명:

미디어 유형	역할	일반적인 용도
오디오	`reference_audio`	배경 음악, 효과음, 음성/대사 참조

오디오 요구사항:

지원 형식: .wav, .mp3
단일 오디오 길이: 2 ~ 30초, 최대 10개, 모든 오디오 총 길이 <= 30초
단일 파일 크기: 15MB 이하
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
오디오 URL은 서버에서 직접 접근 가능해야 합니다

Video Edit / Video Extend

참조 오디오 URL 배열, 선택 사항이며 제공 시 1~10개

필수 조건: 이 모델은 video_urls가 필수이며, 오디오는 선택적인 보조 참조 소재입니다.

역할 설명:

미디어 유형	역할	일반적인 용도
오디오	`reference_audio`	배경 음악, 효과음, 음성/대사 참조

오디오 요구사항:

지원 형식: .wav, .mp3
단일 오디오 길이: 2 ~ 30초, 최대 10개, 모든 오디오 총 길이 <= 30초
단일 파일 크기: 15MB 이하
요청 본문 총 크기 64MB 이하, Base64 인코딩을 사용하지 마세요
오디오 URL은 서버에서 직접 접근 가능해야 합니다

Required array length: 1 - 10 elements

예시:

["https://example.com/bgm.mp3"]

duration

integer

지원 모드: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video / Image-to-Video

비디오 길이(초), 기본값은 5초

설명:

4~30초 사이의 임의의 정수값을 지원합니다
-1: 자동 길이. 모델이 4–30초 범위에서 결정하며 실제 출력 길이에 따라 과금됩니다
재생 시간은 과금에 직접적으로 영향을 미칩니다

Reference-to-Video

출력 비디오 길이(초), 기본값은 5초

설명:

4~30초 사이의 임의의 정수값을 지원합니다
-1: 자동 길이. 모델이 4–30초 범위에서 결정하며 실제 출력 길이에 따라 과금됩니다
재생 시간은 과금에 직접적으로 영향을 미칩니다

프롬프트가 비디오 편집 작업으로 판정되면 -1만 유효하며, 구체적인 초를 전달하면 제출 시에는 오류 없이 이후 작업이 실패합니다

Video Edit

출력 비디오 길이(초), 기본값은 -1

설명:

-1만 지원: 출력 길이는 입력 비디오를 따릅니다(최대 0.4초 짧아질 수 있음)
임의의 길이는 지정할 수 없으며 구체적인 초를 전달하면 거부됩니다
길이는 과금과 직접 연관됩니다

Video Extend

출력 비디오 길이(초), 기본값은 5초

설명:

4–30초 사이의 임의의 정수값 지원
-1: 자동 길이. 실제 출력 길이에 따라 과금됩니다
길이는 과금과 직접 연관됩니다

예시:

8

quality

enum<string>

기본값:720p

지원 모드: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

비디오 해상도, 기본값은 720p

선택 가능한 값:

480p: 낮은 해상도, 낮은 가격
720p: 표준 해상도, 기본값
1080p: 초고해상도

초안 모드: draft가 true이면 480p만 사용할 수 있으며, 생략해도 자동으로 480p가 적용됩니다

사용 가능한 옵션:

480p,

720p,

1080p

예시:

"720p"

draft

boolean

기본값:false

지원 모드: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

초안 모드 활성화 여부로, 기본값은 false입니다

설명:

true: 먼저 480p 초안 비디오를 생성합니다. 더 빠르게 생성되며 일반 480p 요금이 적용됩니다
활성화 시 quality는 480p로 지정하거나 생략해야 합니다. 다른 해상도를 전달하면 400 파라미터 오류가 반환됩니다
요청 본문의 최상위에만 지정할 수 있습니다. model_params 안에 지정하면 400 파라미터 오류가 반환됩니다

최종 비디오로 변환:

초안이 완료되면 작업 조회 응답에 draft_expires_at이 반환됩니다
이 시각 이전에 Seedance 2.5 Draft-to-Video에 초안의 작업 ID를 전달하면 동일한 내용의 1080p 최종 비디오를 생성할 수 있습니다
최종 비디오와 초안은 별도로 과금됩니다. 초안이 만족스럽지 않다면 변환하지 않고 초안 요금만 지불할 수 있습니다
기본 유효기간은 초안 완료 후 24시간이며, 실제 기한은 draft_expires_at을 기준으로 합니다. 대기 중에 유효기간이 만료되어도 변환에 실패하므로 변환 요청을 미리 제출하세요

일시적으로 사용할 수 없는 경우: 서비스를 일시적으로 사용할 수 없으면 503이 반환될 수 있습니다. 오류 코드가 draft_unavailable이면 나중에 다시 시도하거나 draft를 제거하고 일반 모드로 생성하세요

예시:

false

aspect_ratio

enum<string>

기본값:adaptive

지원 모드: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video

비디오 화면 비율, 기본값은 adaptive

선택 가능한 값:

16:9(가로), 9:16(세로), 1:1(정사각형), 4:3, 3:4, 21:9(울트라와이드)
adaptive: 모델이 프롬프트에 따라 최적의 화면 비율을 자동 선택

각 해상도별 픽셀 값:

화면 비율	480p	720p	1080p
16:9	854×480	1280×720	1920×1080
4:3	752×560	1112×834	1664×1248
1:1	640×640	960×960	1440×1440
3:4	560×752	834×1112	1248×1664
9:16	480×854	720×1280	1080×1920
21:9	992×432	1470×630	2206×946

Image-to-Video

비디오 화면 비율, Image-to-Video는 adaptive만 지원

선택 가능한 값:

adaptive: 첫 프레임 이미지 비율에 따라 가장 가까운 화면 비율을 자동 선택하며, 이 모델에서 지정 가능한 유일한 값입니다
이 모델에서는 16:9, 9:16 등 고정 비율을 지정할 수 없습니다

Reference-to-Video

비디오 화면 비율, 기본값은 adaptive

선택 가능한 값:

16:9(가로), 9:16(세로), 1:1(정사각형), 4:3, 3:4, 21:9(울트라와이드)
adaptive: 프롬프트 의도에 따라 판단, 우선순위: 비디오 > 이미지 > 프롬프트

각 해상도별 픽셀 값:

화면 비율	480p	720p	1080p
16:9	854×480	1280×720	1920×1080
4:3	752×560	1112×834	1664×1248
1:1	640×640	960×960	1440×1440
3:4	560×752	834×1112	1248×1664
9:16	480×854	720×1280	1080×1920
21:9	992×432	1470×630	2206×946

프롬프트가 비디오 편집 / 연장 작업으로 판정되면 adaptive만 유효하며, 고정 비율을 전달하면 제출 시에는 오류 없이 이후 작업이 실패합니다

Video Edit / Video Extend

비디오 화면 비율, 기본값은 adaptive

선택 가능한 값:

adaptive: 출력 비율은 첫 번째 입력 비디오를 따르며, 이 모델에서 지정 가능한 유일한 값입니다
16:9, 9:16 등 고정 비율을 전달하면 거부됩니다

사용 가능한 옵션:

16:9,

9:16,

1:1,

4:3,

3:4,

21:9,

adaptive

예시:

"16:9"

generate_audio

boolean

기본값:true

지원 모드: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

Text-to-Video

동기화된 오디오 생성 여부, 기본값은 true

선택 가능한 값:

true: 비디오에 동기화된 오디오(음성, 효과음, 배경 음악)가 포함되며, 추가 요금이 없습니다. 오디오 생성 효과를 최적화하려면 대화 부분을 큰따옴표로 감싸는 것을 권장합니다
false: 무음 비디오 출력

Image-to-Video / Reference-to-Video / Video Edit / Video Extend

동기화된 오디오 생성 여부, 기본값은 true

선택 가능한 값:

true: 비디오에 동기화된 오디오가 포함되며, 추가 요금이 없습니다
false: 무음 비디오 출력

예시:

true

content_filter

boolean

기본값:true

지원 모드: Text-to-Video, Image-to-Video, Reference-to-Video, Video Edit, Video Extend

콘텐츠 필터, 기본값은 true

선택 가능한 값:

true: 표준 콘텐츠 안전 검사, 기본값입니다
false: 콘텐츠 제한을 완화하며 +10%(1.1x)가 청구됩니다. 불법 및 금지된 콘텐츠는 이 설정과 관계없이 항상 적용됩니다

웹 검색과 함께 사용할 수 없음:

content_filter: false와 model_params.web_search: true는 동시에 사용할 수 없으며, 함께 전달하면 400 파라미터 오류가 반환됩니다
웹 검색이 필요한 경우 content_filter: true(기본값)를 유지하세요

예시:

true

output_format

enum<string>

기본값:mp4

Text-to-Video / Image-to-Video / Reference-to-Video / Video Edit / Video Extend

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

선택 가능한 값:

mp4: H.264 인코딩으로 호환성이 가장 좋고 표준 색상 정밀도를 제공하며, 기본값입니다
mov: H.264 + yuv444p 크로마 서브샘플링 + PCM 오디오로 색 재현력이 높아 색보정·키잉·합성 등 후반 작업에 적합합니다. 브라우저 내 재생이 지원되지 않을 수 있으므로 다운로드 후 VLC / mpv / ffplay로 재생하세요. 추가 요금 없음

Draft-to-Video

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

선택 가능한 값:

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

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

사용 가능한 옵션:

mp4,

mov

예시:

"mp4"

model_params

object

지원 모드: Text-to-Video

모델 확장 파라미터

Show child attributes

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-text-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 전체 파라미터 가이드

Text-to-Video

Image-to-Video

Reference-to-Video

Video Edit

Video Extend

Draft-to-Video

인증

본문

응답