메인 콘텐츠로 건너뛰기
POST
POST /v1/videos/generations로 제출하고 data[0].task_id를 받은 뒤 GET /v1/tasks/{task_id}로 조회합니다.
string
필수
Authorization: Bearer <token>을 사용합니다. <token>은 APIMart API 키입니다.

요청 매개변수

string
필수
seedance-2-5-flash를 사용합니다. doubao-seedance-2-5-flash도 허용합니다. 점이 포함된 seedance-2.5-flash는 지원하지 않습니다.
boolean
기본값:"false"
비디오 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
차단 시 HTTP 400(nsfw_content_detected)을 반환하며 작업을 생성하거나 생성 요금을 부과하지 않습니다. 참조 동영상·오디오는 검토하지 않습니다. 검토 서비스 오류 시 요청이 계속 진행될 수 있습니다.
string
필수
필수 프롬프트입니다. @图片1 / @视频1 / @音频1로 소재를 참조합니다. 번호는 1부터 시작하며 각 소재 배열의 순서에 대응합니다.
string
기본값:"720p"
480p / 720p만 지원하며 기본값은 720p입니다. 1080p, 2k, 4k 등은 제출 시 HTTP 400을 반환합니다.
string
기본값:"adaptive"
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive(기본값)를 지원합니다. 별칭은 aspect_ratio입니다. 시작·끝 프레임, 편집, 연장 작업은 adaptive만 가능합니다.
integer
정수 초 4–30; 일반 요청에서 생략하면 5, -1은 자동입니다. 명시적 edit는 -1 또는 생략만 허용하며, 생략 시 -1로 처리하고 원본 길이를 따릅니다. 자동 길이는 30초분을 선차감한 후 실제 토큰 사용량으로 정산합니다.
boolean
기본값:"true"
출력 오디오 생성 여부로 기본값은 true이며 별칭은 audio입니다. 입력 참조 오디오인 audio_urls와 다릅니다.
boolean
기본값:"false"
AI 생성 워터마크 추가 여부로 기본값은 false입니다.
integer
선택적 난수 시드입니다. 같은 시드가 동일한 결과를 보장하지는 않습니다.
string
기본값:"mp4"
출력 컨테이너는 mp4(기본값) 또는 mov입니다.
string
기본값:"auto"
auto(기본값), reference, edit, extend를 지원하며 참조 소재가 있는 작업에만 사용합니다. 유형을 명시하면 제출 시 아래 제한을 검사합니다.
string[]
모두 reference_image로 처리하는 참조 이미지 배열입니다. image_with_roles와 합쳐 최대 10장입니다. 시작·끝 프레임은 image_with_roles를 사용하세요.
object[]
각 항목에 url과 role이 필요합니다. 역할은 reference_image, first_frame(최대 1장), last_frame(최대 1장, 시작 프레임과 함께)입니다. image_urls와 합쳐 최대 10장이며 충돌하는 역할을 혼합하지 마세요. video_urls / audio_urls가 있으면 시작·끝 프레임은 멀티모달 참조 이미지로 처리됩니다.
string[]
최대 5개, 각 2–30초, 합계 30초 이하입니다. 편집용 원본 동영상은 4–30초여야 합니다.
string[]
최대 5개, 각 2–30초, 합계 30초 이하입니다. 오디오만 참조할 수 있으며 이미지나 동영상이 필수는 아닙니다.
boolean
기본값:"false"
true이면 성공 후 끝 프레임 이미지를 data.result.videos[].last_frame_url로 반환합니다.
모델이 필요에 따라 웹을 검색하도록 허용합니다. 기본값은 false입니다.
object[]
선택적 도구 목록입니다. 웹 검색 예: [{"type":"web_search"}].
draft / draft_task_id는 지원하지 않으므로 요청에서 제거하세요. 포함하면 제출 시 HTTP 400을 반환합니다. 초안 기능은 Seedance 2.5를 사용하세요.

소재 요구 사항

공개 접근 가능한 http(s) URL 또는 승인된 asset:// ID를 사용합니다. 출력 해상도와 입력 동영상 픽셀 제한은 별도로 검사합니다.

작업 유형과 제한

명시한 유형의 제한을 위반하면 작업 생성·과금 전에 HTTP 400을 반환합니다. auto는 소재와 프롬프트로 유형을 판단하므로 생성 중에 제한 위반으로 실패할 수 있습니다. 명시적 유형도 프롬프트 의도와 다르면 InvalidParameter.TaskTypeMismatch가 발생할 수 있습니다.

요청 예제

멀티모달 참조

시작·끝 프레임

동영상 편집

동영상 연장

비공개 소재 사용

실제 사람의 얼굴이 있는 이미지·동영상은 소재 라이브러리 승인 후 asset://로 사용하세요. 업로드 model도 seedance-2-5-flash로 설정합니다. 소재 라이브러리 API를 참고하고 아래 Flash 모델명을 사용하세요.
통합 작업 API로 소재 검토를 조회합니다. 승인 후 소재 목록에서 asset:// ID를 받아 image_urls, image_with_roles[].url, video_urls, audio_urls에 사용합니다.

작업 상태와 결과

작업 조회 API를 폴링합니다. pending / processing은 진행 중, completed는 성공, failed는 실패입니다. data.result.videos[0].url[0]을 읽으세요. url은 배열입니다.

요금 계산

  • 제출 시 해상도별 초당 단가로 선차감합니다. 참조 동영상이 있으면 입력 포함 요금 구간을 사용하며 출력 길이와 참조 동영상 총길이를 합산합니다.
  • 일반 요청의 duration 생략은 출력 5초, duration: -1 또는 edit의 길이 생략은 출력 30초를 기준으로 선차감합니다.
  • 성공 후 data.usage.completion_tokens ÷ 1,000,000 × 해당 100만 토큰당 단가에 계정 할인을 적용하여 차액을 환불하거나 추가 차감합니다. 참조 동영상 유무에 따라 token / token-input 구간을 사용합니다. 최종 금액은 data.cost입니다.
  • 제출 거절 시 생성 요금은 없고, 생성 실패 시 선차감액을 환불합니다. 단가와 할인은 가격 페이지를 확인하세요.

일반적인 오류