Seedance 2.5 사용법: 공식 API와 EvoLink 접근 가이드
Seedance 2.5 공식 API와 EvoLink 연동이 모두 출시되었습니다. 아래에서는 공식 앱부터 EvoLink API까지의 경로를 다룹니다. 이 글은 독립적인 가이드이며 이 사이트는 ByteDance와 제휴 관계가 없습니다. EvoLink 키를 만들고 짧은 테스트부터 시작하며 확대 전에 현재 가격과 계정 제한을 확인하세요.
경로 1: 공식 앱 (Dreamina, CapCut)
ByteDance는 Dreamina 등 자사 크리에이티브 앱을 통해 Seedance 2.5를 선보이고 있습니다. 이미 Dreamina나 CapCut 요금제를 사용 중이고 거주 지역에 액세스가 열려 있다면, 이것이 가장 통합된 경험이 될 수 있습니다 — 생성, 편집, 게시가 한곳에서 이루어집니다. 유의할 점은, 배포가 지역과 요금제별로 단계적으로 진행될 수 있으며, 사용량이 많으면 요금제 한도에 금방 도달하기 쉽다는 것입니다.
경로 2: EvoLink live API
EvoLink는 이 사이트가 추천하는 third-party Seedance 2.5 provider입니다. T2V, I2V, R2V model ID가 출시되었습니다. 요금표와 콘솔에서 현재 가격을 확인하고 API 퀵스타트에서 짧은 2.5 테스트를 실행하세요. 2.0은 rollback으로 유지합니다.
코드를 작성하고 싶지 않다면 두 가지 방법이 있습니다. 저희 플레이그라운드에서 샷을 세팅해 — prompt를 작성하고 길이와 화질을 선택한 뒤 — 설정을 EvoLink로 그대로 가져가거나, prompt 라이브러리에서 공식 케이스를 열어 전체 prompt와 출시 tier 설정을 원클릭으로 EvoLink 생성기에 바로 보낼 수 있습니다. agent로 구동할 수도 있습니다.
워크플로 선택: 각 model ID가 하는 일
| 워크플로 | Model ID | 필수 입력 | 적합한 용도 |
|---|---|---|---|
| Text-to-video | seedance-2.5-text-to-video | prompt | prompt만으로 만드는 테이크, 가장 빠른 출발점 |
| Image-to-video | seedance-2.5-image-to-video | prompt + 프레임 이미지 1~2장 | 첫 프레임(또는 첫/마지막 프레임)으로 구도 고정 |
| Reference-to-video | seedance-2.5-reference-to-video | prompt + 참조 유형 최소 1가지 | 캐릭터/제품 일관성, 모션 전이, 오디오 싱크 |
미리 알아 둘 함정 두 가지: image-to-video의 prompt는 필수입니다 — 프레임 이미지만으로는 제출할 수 없습니다 — 그리고 프레임 한도는 이미지 2장입니다. 일관성 제어를 위해 더 많은 asset이 필요하다면 image-to-video에 이미지를 밀어 넣지 말고 reference-to-video로 전환하십시오.
prompt 자체의 상한은 10,000 token이며, route documentation은 영어 기준 약 1,000단어를 권장합니다 — prompt가 길다고 더 잘 따르는 것이 아니므로, 그 예산은 정확한 카메라 언어에 쓰는 편이 낫습니다.
prompt 작성: 묘사하지 말고 지시하기
품질을 좌우하는 가장 큰 지렛대는, 소원을 비는 사람이 아니라 감독처럼 prompt를 쓰는 것입니다. 비교해 보십시오.
❌ “석양의 아름다운 도시, 시네마틱, 고품질”
✅ “골든아워에 해안 도시 상공에서 드론 풀백, 아나모픽 플레어, 가로등이 하나씩 켜지는 동안 항구 위로 천천히 돌리 아웃”
두 번째 prompt는 카메라(드론 풀백, 느린 돌리 아웃), 조명(골든아워, 플레어), 그리고 타이밍이 있는 이벤트(가로등이 하나씩 켜짐)를 명시합니다. Seedance 2.5는 카메라 용어를 잘 따를 것으로 예상됩니다 — 휩팬, 랙 포커스, 크레인 무브, 핸드헬드 흔들림 모두 명시적으로 적을 가치가 있습니다.
대체로 좋은 결과를 내는 구조는 다음과 같습니다.
- 샷 유형 + 카메라 움직임 — “매크로 렌즈 푸시인”, “핸드헬드 트래킹 샷”
- 피사체 + 액션 — 무엇이 일어나는지, 순서대로
- 조명 + 분위기 — “역광의 증기”, “나트륨등 가로등”
- 스타일 앵커 — 필름 스톡, 시대, 장르
prompt 라이브러리에서 설정이 첨부된 실전 예시를 가져다 쓰십시오.
참조 자료 사용하기
참조는 공개된 2.5 제품 데모가 돋보이는 지점입니다. live reference-to-video route는 요청당 이미지 30개, 영상 10개, 오디오 10개까지 받습니다 — 한도를 채우는 것이 목표가 아니라, 이 예산 안에서 파일마다 역할을 계획하는 것이 핵심입니다.
| 참조 유형 | 고정되는 것 | 문서화된 route 스펙 | 실용 팁 |
|---|---|---|---|
| 이미지 (최대 30) | 캐릭터, 제품, 장소, 색감 | jpeg/png/webp, 300~6000px, 개당 ≤30MB | 승인된 소수의 identity set이 디버깅하기 쉽습니다 |
| 비디오 클립 (최대 10) | 카메라 움직임, 모션 스타일, 이펙트 | mp4/mov, 개당 2~30초, 합산 ≤30초, 개당 ≤200MB | 모션 역할은 한 번에 하나씩 추가하십시오 |
| 오디오 파일 (최대 10) | 템포, 리듬, 분위기 | wav/mp3, 개당 2~30초, 합산 ≤30초, 개당 ≤15MB | 권리가 확보된 깨끗한 소스를 사용하십시오 |
참조는 파일 업로드가 아니라 URL로 제출됩니다 — 모든 링크가 태스크의 전체 수명 동안 접근 가능한지 확인하십시오. 렌더링 도중 만료되는 signed URL은 가장 흔한 조용한 실패 원인 중 하나입니다.
효과가 검증된 워크플로는 다음과 같습니다. 먼저 prompt만으로 테이크를 돌려 샷을 찾고, 그다음 참조 자료를 한 겹씩 추가합니다 — 캐릭터 먼저, 그다음 카메라 움직임, 마지막으로 오디오입니다. 한꺼번에 전부 추가하면 실패 원인을 진단할 수 없게 됩니다.
길이, 화질, 오디오: 기본값과 옵션
파라미터를 생략하면 route가 기본값을 적용합니다 — 기본값을 알아 두면 “왜 내 클립이 5초지”라는 혼란을 줄일 수 있습니다:
| 파라미터 | 기본값 | 옵션 |
|---|---|---|
duration | 5초 | 4~30초 |
quality | 720p | 480p / 720p |
aspect_ratio | adaptive (입력 또는 prompt를 따름) | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive |
generate_audio | true | false면 무음 영상 출력 |
content_filter | true | 문서에는 비활성화 시 약 10% surcharge가 표기됨 — 콘솔 청구서에서 확인 |
두 가지 리마인더: 세로형 콘텐츠는 adaptive의 추측에 맡기지 말고 9:16을 명시적으로 전달하고, 후반에서 오디오를 더빙하는 파이프라인에서는 generate_audio를 꺼 두십시오 — 그렇지 않으면 모든 테이크에 쓰지 않을 트랙이 함께 나옵니다. billing 동작은 여전히 콘솔과 현재 documentation이 기준이며, route capability는 configurable하게 유지하십시오.
예산을 태우지 않고 반복하기
live 2.5 route에서 low-risk smoke test를 먼저 실행해 cost baseline을 만들고, 콘솔의 현재 가격과 실제 billing record를 요금표와 대조하십시오.
흔한 실패 유형
- 테이크 중간에 얼굴이 변형됨 — 캐릭터 참조 이미지를 추가하십시오. prompt에만 의존하지 마십시오.
- 카메라가 멈춰 있음 — 움직임을 지정하지 않았기 때문입니다. 정적인 prompt는 정적인 샷을 만듭니다.
- 오디오가 컷과 어긋남 — 동기화를 명시적으로 기술하고(“다운비트마다 조명이 바뀐다”), 해당 트랙을 오디오 참조로 제공하십시오.
플레이그라운드에서 첫 테이크를 세팅하고, 프로덕션으로 옮기기 전에 provider 지원 여부와 가격을 확인하십시오.