ByteDance
Seedance 2.5 Flash
seedance-2.5-flash/text-to-video
바이트댄스 Seedance 2.5 시리즈 비디오 모델로, 텍스트-투-비디오, 첫 프레임 기반 생성 및 멀티모달 참조 생성을 지원하며, 1회 출력은 4~30초이고 480p 또는 720p를 선택할 수 있으며 동기화된 오디오를 생성해 광고 숏클립과 이커머스 제품 영상의 빠른 제작에 적합합니다
seedance-2.5-flash/text-to-video 사용해 보기
입력
작품 갤러리
모든 작품 보기출력
video가격
seedance-2.5-flash/text-to-video per second
| 사양 | 단가 |
|---|---|
| 480P | $0.0679 |
| 720P | $0.1525 |
포지셔닝 소개
이것은 텍스트-투-비디오 모델로, 텍스트 프롬프트 한 줄만 입력하면 오디오 트랙이 포함된 연속 비디오 클립을 생성합니다. 길이는 4~30초, 해상도는 480p 또는 720p로 개방되며, 화면 비율은 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 및 자동 선택 중에서 고를 수 있고 MP4 또는 MOV로 출력됩니다. 기본적으로 동기화된 대사, 음향 효과와 배경음을 생성합니다. 광고, 이커머스, 소셜 미디어 및 내러티브 단편 제작자에게 적합하며, 창의적인 문안을 빠르게 집행 가능한 비디오 자산으로 전환하는 데 사용됩니다.
핵심 하이라이트
- 프롬프트로 오디오 트랙 포함 비디오 바로 출력——기본적으로 동기화된 대사, 음향 효과 및 배경 오디오를 생성하여 후반 작업의 사운드 보충 단계를 줄여줍니다.
- 1회 길이 4~30초 지원——길이 파라미터를 4~30초 사이로 설정할 수 있어 하나의 완성된 숏 비디오나 광고 장면에 적합합니다.
- 일곱 가지 화면 비율 자동 선택——16:9, 4:3, 1:1, 3:4, 9:16, 21:9 및 자동 선택을 지원하여 가로, 정사각형, 세로 화면을 모두 커버합니다.
- 480p와 720p 듀얼 해상도——출력 해상도를 480p 또는 720p 중 선택할 수 있어 빠른 미리보기와 비교적 선명한 완성본을 모두 고려합니다.
기능 설명
텍스트 프롬프트로 비디오 생성: 최대 5000자 프롬프트를 입력하여 장면, 피사체, 카메라 무빙과 동작을 묘사하고 해당 비디오 클립을 생성합니다. 예측 가능성을 높이려면 프롬프트를 구체적으로 작성해야 합니다.
길이 및 해상도 제어: 단일 요청 시 4~30초 길이를 설정할 수 있고, 해상도는 480p 또는 720p 중 하나를 선택하며 요청 길이 기준으로 과금됩니다.
다양한 화면 비율과 자동 선택: 화면 비율은 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 또는 adaptive를 선택할 수 있으며, adaptive는 모델이 프롬프트에 따라 적절한 비율을 선택합니다.
오디오 동기화 생성: 기본적으로 오디오 생성이 켜져 있어 화면과 함께 동기화된 대사, 음향 효과 및 배경 오디오를 생성합니다. 오디오를 끄고 화면만 출력할 수도 있습니다.
MP4 및 MOV 출력: 출력 형식은 MP4 또는 MOV를 선택할 수 있으며, MP4가 호환성 중심의 기본값이고 MOV는 전문 후반 제작 흐름을 겨냥합니다.
적용 시나리오
- 광고 팀이 문안으로 브랜드 단편 생성——초반 전개, 카메라 무빙, 동작과 마무리를 담은 프롬프트를 입력하여 4~30초의 오디오 트랙 포함 비디오를 생성하고 광고 집행이나 제안 미리보기에 사용합니다.
- 이커머스 운영자가 상품 전시 장면 생성——상품 외관과 사용 장면을 텍스트로 묘사하고 정사각형 또는 세로 화면 비율을 선택하여 상품 상세 페이지나 피드용 숏 비디오 소재를 제작합니다.
- 소셜 미디어 크리에이터가 세로형 콘텐츠를 대량 제작——9:16 또는 1:1 비율에 30초 이내 길이를 조합하여 창의적인 문안을 음향 효과가 포함된 숏 비디오로 전환해 플랫폼 일상 업데이트에 사용합니다.
- 내러티브 단편 작가가 연속 장면 생성——상세한 프롬프트로 다수의 캐릭터와 장면 동작을 묘사하고 1회 최대 30초의 연속 클립을 생성하여 숏 콘텐츠의 스토리 단락으로 활용합니다.
제한 사항 및 선택 가이드
1회 생성 길이 상한은 30초이며, 더 긴 콘텐츠는 분할 생성 후 이어 붙여야 합니다. 출력 해상도는 480p 또는 720p뿐이며 더 높은 화질은 제공하지 않습니다. 화면 비율은 일곱 가지 중 하나를 선택하며 한 번의 요청으로 여러 비율을 동시에 얻을 수 없습니다. 프롬프트는 최대 5000자이며 초과 시 간추려야 합니다. 오디오 생성을 끄면 출력 비디오에 오디오 트랙이 없고, 오디오가 기본 활성화 상태일 때는 화면과 함께 동기화된 대사, 음향 효과 및 배경 오디오가 생성됩니다.
텍스트-투-비디오 · 최대 30초 · 480p/720p
seedance-2.5-flash 텍스트-투-비디오
텍스트 프롬프트를 입력하면 오디오 트랙이 포함된 연속 비디오 클립을 생성합니다. 길이, 해상도, 화면 비율과 출력 형식을 필요에 따라 설정할 수 있어 광고, 이커머스, 소셜 미디어 및 내러티브 단편의 빠른 제작에 적합합니다.
- 입력 방식텍스트 프롬프트
- 길이 범위4–30초
- 해상도480p / 720p
- 출력 형식MP4 / MOV
프롬프트에 장면, 피사체, 카메라 무빙과 동작을 구체적으로 묘사할수록 생성 결과가 더 예측 가능합니다.
옅은 해무에 싸인 새벽의 조용한 낡은 어항. 카메라는 바닷물이 느린 리듬으로 밀려올라가고 물러나며 물거품이 갈라진 틈 사이로 흐르는 젖은 돌계단 가까이 낮은 위치에서 시작한다. 이어 부두를 따라 앞으로 그리고 살짝 위로 떠오르며, 감겨 있는 밧줄과 녹슨 계선 고리를 지나 각자의 줄에 기대어 부드럽게 흔들리는 작은 나무배들을 향한다. 빛바랜 유포를 걸친 어부가 허리를 굽혀 밧줄을 당기고 그의 입김이 보인다. 멀리 등대의 불빛이 안개 너머로 은은하게 깜빡이고 갈매기들이 수면 위를 낮게 스친다. 해무가 옅어지면서 회청색 빛이 점차 옅은 금빛으로 따뜻해지고 반사로 반짝이는 젖은 표면이 드러난다. 꾸준한 부유감 있는 움직임, 서두르지 않는 템포, 전경의 얕은 심도, 부드러운 안개 확산과 자연스러운 바다 소리 분위기.
01
성능
성능은 어떤가: 검증 가능한 네 가지 능력
아래 능력은 모두 텍스트 프롬프트를 입력으로 하며, 길이, 해상도, 화면 비율과 오디오 스위치가 목표에 부합하는지 중점적으로 확인합니다.
텍스트 프롬프트로 비디오 생성
텍스트로 장면, 피사체, 카메라 무빙과 동작을 묘사하면 모델이 이를 바탕으로 비디오 클립을 생성합니다. 프롬프트 상한은 5000자이며, 화면이 묘사에 부합하는지 확인하기 쉽도록 핵심 시각 요소를 명확히 작성하는 것이 좋습니다.
빨간 쉘 재킷을 입은 외로운 아이스 클라이머가 두 개의 아이스 액스로 얼어붙은 푸른 폭포를 오른다. 차가운 공기 속에 입김이 보인다. 카메라는 얼음벽을 따라 그보다 살짝 위에서 가까이 트래킹하며, 액스가 내리칠 때마다 튀어 나가는 얼음 파편을 잡아낸다. 낮은 진동음이 능선을 가로질러 울리고, 눈먼지 기둥이 절벽 위로 쏟아져 빠르게 커진다. 클라이머는 위를 올려다본 뒤 빠르고 의도적인 스윙으로 옆으로 이동하며, 흰 눈더미가 그의 뒤쪽 얼음을 휩쓸고 지나갈 때 눈사태의 경로를 벗어난다. 차가운 주광, 얼음 속 짙은 푸른 그림자, 바람에 날리는 거친 눈 입자, 끝에서 산면의 더 넓은 전경으로 정착하는, 꾸준한 핸드헬드의 긴박감.
길이 및 해상도 설정
단일 요청 길이는 4~30초 사이로 설정할 수 있고, 해상도는 480p 또는 720p 중 선택합니다. 요청 길이 기준으로 과금되므로 생성 전에 완성본 용도에 필요한 길이와 선명도를 먼저 확인하세요.
다양한 화면 비율과 자동 비율
화면 비율은 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 및 adaptive를 지원합니다. adaptive는 모델이 프롬프트에 따라 비율을 선택하며, 게재 레이아웃이 아직 정해지지 않은 탐색 단계에 적합합니다.
오디오 생성 및 형식 선택
기본적으로 화면과 함께 동기화된 대사, 음향 효과와 배경 오디오를 생성하며 끌 수도 있습니다. 출력 형식은 MP4 또는 MOV를 선택할 수 있으며, 전자는 일반적인 재생과 공유에 호환되고 후자는 전문 후반 작업 흐름을 겨냥합니다.
명확한 텍스트 묘사와 분명한 길이, 화면 비율, 해상도 파라미터를 사용하면 오디오 트랙이 포함된 비디오 클립을 얻을 수 있습니다. 생성 후에는 화면과 프롬프트의 부합도 및 오디오 스위치 상태를 중점적으로 확인하세요.
02
시작하기
텍스트 묘사에서 완성된 비디오까지
체험하러 가기 →목표를 명확히 하는 것부터 생성 검수까지, 단계별로 입력과 파라미터를 설정하며 매번 한 가지 범주의 내용만 조정합니다.
- 프롬프트예: 해변의 일몰, 인물이 해변을 따라 걸음, 카메라가 천천히 따라감
하나의 완전한 텍스트 묘사
01
구체적인 프롬프트 작성
프롬프트에 장면, 피사체, 카메라 무빙과 동작을 명확히 작성하고 5000자 이내로 유지하세요. 묘사가 구체적일수록 결과가 더 예측 가능합니다.
✓검수
→
02
길이와 화면 비율 설정
용도에 따라 4~30초 길이를 선택하고 480p 또는 720p 해상도를 지정하세요. 화면 비율은 게재 플랫폼에 맞춰 가로, 세로, 정사각형 또는 자동을 선택합니다.
✓검수
→
03
오디오와 출력 형식 선택
오디오 생성 여부를 확인하세요. 출력 형식은 MP4 또는 MOV를 선택할 수 있습니다. 생성 후에는 화면과 프롬프트의 부합도 및 오디오 트랙 존재 여부를 확인하세요.
03
시나리오
어디에 쓰나: 세 가지 대표 숏 영상
브랜드 단편 및 광고 미리보기
광고 팀이 초반 전개, 카메라 무빙, 동작과 마무리를 담은 텍스트 프롬프트로 오디오 트랙이 포함된 단편을 생성하여 집행 전 미리보기나 제안에 사용합니다. 화면 리듬과 오디오가 동기화되는지 중점적으로 확인하세요.
이커머스 상품 전시 장면
이커머스 운영자가 상품 외관과 사용 장면을 텍스트로 묘사하고 정사각형 또는 세로 화면 비율을 선택하여 숏 비디오를 생성하고 상품 상세 페이지나 피드 소재로 사용합니다. 상품 외관이 묘사에 부합하는지 확인하세요.
소셜 미디어 세로형 숏 비디오
크리에이터가 9:16 또는 1:1 비율, 30초 이내 길이로 음향 효과가 포함된 숏 비디오를 생성하여 플랫폼 일상 업데이트에 사용합니다. 생성 후 화면 비율이 플랫폼 요구 사항과 일치하는지, 오디오 스위치가 필요에 맞는지 확인하세요.
04
연동
연동: 당신의 제품이나 AI 도구에서 seedance-2.5-flash 호출하기
HiAPI API Key 하나면 사용할 수 있으며, 모든 방식이 동일한 계정과 과금을 공유합니다.
- API Key 생성
- 연동 방식 하나 선택
오른쪽에서 하나를 골라 복사하면 됩니다
- AI 프로그래밍 도구 추천
Claude Code, Cursor, Codex 등에서 명령으로 MCP 연동
- API 직접 연결
자체 제품, 백엔드 서비스, 자동화 흐름
- 어떤 방식을 고를지 모르겠다면
AI에게 한 단락을 복사해 주고 선택과 단계를 안내받으세요
Agent Skills · SDK · llms.txt · 모든 연동 방식 →
터미널 · Claude Code
claude mcp add --transport http hiapi https://mcp.hiapi.ai/mcp \
--header "Authorization: Bearer YOUR_API_KEY"연동 후 AI에게 목표를 바로 알려주면 seedance-2.5-flash를 호출하고 작업 진행 상황을 조회해 결과를 받을 수 있습니다. Cursor, Codex 등 도구의 설정 단계는 아래 튜토리얼을 참고하세요.
Agent 연동 튜토리얼 보기 →API로 당신의 제품에 연동
API Key로 현재 모델의 작업을 제출하고, 반환된 작업 ID로 상태를 조회하세요. 요청 파라미터는 이 페이지의 인터페이스 설명과 동일한 회선 데이터를 사용하며, 예시의 입력 내용을 실제 소재로 교체해 주세요.
# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true
}
}'AI가 연동 방식을 선택하도록 도움받기
HiAPI 문서 인덱스 https://hiapi.ai/llms.txt 를 읽어 주세요. 프로젝트에서 seedance-2.5-flash를 사용하고 싶습니다. 먼저 제 사용 시나리오에 따라 Remote MCP, Agent Skills, 아니면 API 직접 연결 중 적합한 방식을 판단해 주세요. 필요하면 먼저 핵심 질문 하나를 한 뒤 가장 간단한 연동 단계와 입력해야 할 설정을 알려 주세요.
이 내용을 복사해 사용 중인 AI 도구에 보내고, 프로젝트 언어, 입력 소재와 기대 결과를 덧붙이세요. 이를 바탕으로 연동 방식과 다음 단계를 안내받을 수 있습니다.
새소식
변경 이력 보기 →- 새 모델 seedance-2.5-flash/reference-to-video 출시
- 새 모델 seedance-2.5-flash/image-to-video 출시
- 새 모델 seedance-2.5-flash/text-to-video 출시
생성 작업 제출
https://api.hiapi.ai/v1/tasks 헤더
Authorizationstring필수계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기
Content-Typestring선택요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.
Idempotency-Keystring선택멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.
네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.
본문
modelstring필수현재 고정 값: seedance-2.5-flash/text-to-video
routestring선택현재 고정 값: default
inputobject필수
seedance-2.5-flash/text-to-video 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.
promptstring필수minLength 1maxLength 5000생성하려는 비디오 콘텐츠를 설명하는 텍스트 프롬프트입니다. 장면, 피사체, 카메라 움직임과 동작을 구체적으로 설명할수록 생성 결과를 더 예측 가능하게 만들 수 있습니다.
durationinteger선택기본값: 5min 4max 30출력 비디오 길이(초)이며, 값 범위는 4에서 30이고 기본값은 5입니다. 과금은 요청한 길이를 기준으로 계산됩니다.
resolutionstring선택기본값: "480p"출력 해상도입니다. Seedance 2.5 Flash는 480p와 720p를 지원하며 기본값은 480p입니다.
480p720paspect_ratiostring선택기본값: "adaptive"출력 화면의 가로세로 비율이며, 기본값은 adaptive로 모델이 프롬프트에 따라 적합한 비율을 자동으로 선택합니다.
16:94:31:13:49:1621:9adaptiveoutput_formatstring선택기본값: "mp4"출력 파일 형식이며, 기본값은 mp4(호환성이 더 좋은 범용 선택)입니다. mov는 전문 후반 제작에 적합합니다.
mp4movgenerate_audioboolean선택기본값: true오디오 생성 여부로, 화면과 동기화된 대사, 음향 효과 및 배경음을 포함하며 기본값은 true입니다.
callbackobject선택
종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.
생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.
urlstring필수callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.
whenstring선택기본값: "final"현재는 final만 지원(success / fail 모두 알림).
finalstoragestring선택기본값: "temp"산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.
temppersistent요청 예시
# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedance-2.5-flash/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": true
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "seedance-2.5-flash/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "adaptive",
"output_format": "mp4",
"generate_audio": True
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} 작업 상세 조회
https://api.hiapi.ai/v1/tasks/:id 응답 필드
taskIdstring필수태스크 ID. 접두사는 항상 tk-hiapi-.
modelstring필수확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.
routestring선택route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.
statusstring필수태스크 상태.
queued 대기 중, 아직 시작되지 않음.
handling 처리 중.
archiving 처리 완료, 산출물 준비 중.
success 종료: 완료. 산출물 사용 가능(output 반환).
fail 종료: 실패(error 반환).
제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.
creatednumber필수태스크 생성 시각(Unix 초).
completednumber필수종료 상태가 된 Unix 초. 비종료 상태에서는 0.
outputarray선택
status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).
Array [ object ]
배열 항목
urlstring필수산출물 URL. 바로 다운로드할 수 있습니다.
typestring필수현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.
expireAtnumber필수산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.
errorobject선택
status == fail일 때만 나타납니다.
codestring필수비즈니스 오류 코드.
messagestring필수오류 설명.
응답 예시
성공
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} 처리 중(비종료)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} 실패
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} 아티클
모든 아티클 보기 →관련 모델
모든 모델 보기 →동일 유형
-
Grok Imagine 1.5 Lite xAI $0.029 /초 -
Muse Video 1.0 Meta $0.034 /동영상 -
MiniMax H3 MiniMax $0.072 /초 -
Gemini Omni 1.1 Google $0.450 /동영상 -
Gemini Omni 1.2 Google $0.023 /초 -
Kling 4.0 Kuaishou $0.204 /초 -
MiniMax H3 Max Turbo MiniMax $0.025 /초 -
PixVerse V6 Max PixVerse $0.030 /초 -
Veo 3.1 Fast Google $0.170 /초 -
Kling 2.5 Kuaishou $0.090 /초 -
HappyHorse 1.1 Alibaba $0.160 /초 -
Seedance 2.5 Flash ByteDance $0.068 /초