Seedance 2.5 사용법 | 요청 필드, 한계, 과금

Seedance 2.5 사용법을 안다는 것은 대체로 그 요청의 형태를 안다는 뜻입니다. 호출 하나가 프롬프트, 네 가지 출력 설정, 최대 세 종류의 레퍼런스 미디어를 실어 나르고, 플랫폼은 작업 id를 반환하며, 완성된 영상은 폴링으로 회수합니다. 옛 버전과 다른 역학은 30초 천장, 레퍼런스 예산의 크기, 그리고 레퍼런스 영상을 요금표가 시사하는 것보다 비싸게 만드는 과금 규칙입니다.

다른 무엇보다 먼저 2.5 위에 있는지 확인합니다

여러 호스트가 2.5를 나란히 추가하면서도 Seedance 2.0을 기본값으로 남겨 두었으므로, 무엇을 받는지는 모델 문자열이 결정합니다. 출시된 2.5 빌드는 -face로 끝나는 식별자로 제공됩니다. 옛 코드 샘플은 그 접미사가 없는 식별자를 인용하는데, 이제는 해석되지 않습니다.

코드를 뒤질 필요가 없는 두 번째 확인도 있습니다. 20초 생성을 요청해 보십시오. 2.0에서는 작업이 존재하기도 전에 길이 필드에서 거부되므로 아무것도 과금되지 않습니다.

호스팅 API로 Seedance 2.5 사용하기

생성 요청은 다음 필드를 받습니다.

필드	범위	기본값
prompt	최대 20,000자	없음
duration	4~30초, 또는 -1	5
resolution	480p, 720p, 1080p	720p
aspect_ratio	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive	adaptive
generate_audio	true 또는 false	true
content_filter	true 또는 false	true

프롬프트는 텍스트로 영상을 만들 때 필수이고 레퍼런스 미디어가 있으면 선택 사항입니다. 안에 따옴표로 묶인 대사는 화면과 같은 패스에서 음성으로 생성되며, 대사·효과음·음악을 아우르는 모노 트랙으로 나옵니다.

duration을 -1로 두면 길이 결정이 모델에게 넘어갑니다. 예약은 30초 상한에서 잡히므로, 이 값을 쓸 때는 최대 길이 클립을 기준으로 예산을 잡으십시오.

그 외에 요청은 mp4 또는 mov를 위한 output_format을 노출하고, 함께 bitrate_mode, watermark, return_last_frame, seed, image_with_roles, omni_reference_task_type, 그리고 tools 배열도 노출합니다. 체이닝에서 중요한 필드는 return_last_frame입니다. 한 생성의 마지막 프레임이 다음 생성의 씨앗이 되기 때문입니다.

요청을 거부시키는 레퍼런스 미디어 규칙

레퍼런스 미디어 검증은 엄격하고 작업이 생성되기 전에 작동합니다. 그래서 거부는 공짜지만, 반복해서 부딪히기도 쉽습니다.

• 이미지: 요청당 최대 30장, jpeg·png·webp·bmp·tiff·gif·heic 또는 heif, 각 30 MB 미만.
• 영상: 최대 10클립, mp4 또는 mov, 각 200 MB 이하, 각 2~30초, 합산 30초.
• 오디오: 최대 10트랙, wav 또는 mp3, 각 15 MB 이하, 각 2~30초, 합산 30초.

이 모두가 공개 HTTP(S) URL이어야 합니다. 데이터 URI는 플랫폼 전역에서 거부되므로 파일을 먼저 호스팅하십시오.

레퍼런스 이미지와 오디오는 청구서에 아무것도 더하지 않습니다. 레퍼런스 영상은 두 가지 방식으로 더하는데, 그것이 다음 절입니다.

보내기 전에 청구서를 계산하기

과금은 완성 영상의 초 단위이고, 요율은 해상도와 레퍼런스 영상 첨부 여부로 정해집니다.

해상도	생성만	레퍼런스 영상 포함
480p	$0.118589	$0.071153
720p	$0.266824	$0.160094
1080p	$0.461856	$0.275904

과금 초는 두 수치 중 큰 쪽입니다. 올림한 레퍼런스 영상 길이에 출력 길이를 더한 값, 또는 출력 길이의 3분의 5를 올림한 값.

왜 중요한지는 계산 예 두 개가 보여 줍니다.

레퍼런스 클립이 없는 1080p 10초 생성은 $0.461856로 10초가 과금되어 약 $4.62입니다.

같은 1080p 10초 출력에 6초 레퍼런스 클립을 붙이면 16초와 17초 중 큰 쪽, 즉 17초가 $0.275904로 과금되어 약 $4.69입니다. 낮아진 요율을 하한이 상쇄합니다.

더 작은 작업에서 효과가 더 날카롭게 드러납니다. 3초 레퍼런스 클립을 붙인 720p 5초 출력은 8초가 아니라 9초가 과금되어 약 $1.44가 되는데, 같은 5초를 맨바닥에서 생성하면 $1.33을 조금 넘습니다.

폴링, 소요 시간, 환불

작업은 비동기입니다. 제출하면 작업 id가 반환되고, 영상은 그 작업이 완료를 보고할 때까지 폴링해서 회수합니다.

생성은 평균 25분입니다. 폴링은 무료이므로 1520초 고정 간격이면 합리적이고, 공격적으로 간격을 늘려 얻을 이점은 없습니다.

실패한 작업은 전액 환불됩니다. 실패한 작업의 사용량 수치를 보면 예약분이 돌아왔는지 알 수 있는데, 배치가 이상하게 굴었을 때 확인해 볼 만합니다.

거부 읽기

안전 거부는 80006 오류를 반환합니다. 이 오류는 어느 단계에서 걸렸는지 특정하지 않으므로 원인은 프롬프트일 수도, 레퍼런스 파일일 수도, 생성된 출력일 수도 있습니다.

프롬프트부터 시작하십시오. 실명이 거론된 실존 유명인, 제3자 지식재산, 불법 콘텐츠는 모델 안에서 차단되고 어떤 호스트 설정으로도 사라지지 않습니다. 그다음 레퍼런스 이미지를 확인하십시오. 제공한 사진 속 얼굴이나 로고가 이름을 부른 것과 같은 결과를 부를 수 있기 때문입니다.

content_filter의 기본값은 true입니다. false로 두면 요청이 덜 제한적인 채널을 거치고 검열은 꺼지지 않습니다. 스위치가 아니라 라우팅 제어이며, 옛 별칭인 nsfw_checker도 여전히 검증을 통과합니다.

자주 묻는 질문

Seedance 2.5는 어떤 모델 문자열로 호출합니까? 출시된 빌드는 -face로 끝나는 식별자를 가집니다. 그 접미사가 없는 식별자는 출시 전 샘플에서 온 것이고 더 이상 해석되지 않습니다.

30초보다 긴 클립은 어떻게 만듭니까? 생성을 이어 붙입니다. 30초가 요청당 천장이므로 더 긴 작품은 편집기에서 이어 붙인 별개의 작업들이고, return_last_frame이 깔끔한 인계 지점을 줍니다.

왜 레퍼런스 영상이 요금표가 시사한 것보다 비쌌습니까? 레퍼런스 클립은 출력에 더해 자기 길이만큼 과금되고, 요청은 올림한 출력 길이의 3분의 5보다 적게 과금되는 법이 없습니다. 둘 중 큰 쪽이 과금 초가 됩니다.

콘텐츠 필터를 끄면 무엇이든 통과합니까? 아닙니다. content_filter를 false로 두면 덜 제한적인 채널이 선택되고 검열은 여전히 적용됩니다. 실존 유명인·제3자 IP·불법 콘텐츠에 대한 모델 수준의 차단은 무엇을 하든 그대로입니다.

한 줄 요약

Seedance 2.5 사용법을 순서대로: -face 모델 문자열을 검증하고, 길이를 430초로 정하고, 해상도와 화면비를 고르고, 무음을 원하는 게 아니라면 오디오는 켠 채 두고, 무료이니 레퍼런스 이미지를 마음껏 붙이고, 제출한 뒤 25분 동안 15초마다 폴링하십시오. 레퍼런스 영상이 끼는 순간 출력 초가 아니라 과금 초로 작업 값을 매기고, error 80006은 환불에 더해 다시 쓰라는 신호로 받아들이십시오.