Volcengine API를 통해 ByteDance의 Seedance 2.0 비디오 생성 모델을 애플리케이션에 통합하세요. 이 가이드는 모든 엔드포인트, Python/cURL/JavaScript 코드 예제, 가격 및 접근 옵션을 다룹니다.
최종 업데이트: 2026년 3월
Seedance 2.0 API는 ByteDance의 Volcengine(화산엔진) 클라우드 플랫폼을 통해 제공됩니다. 텍스트 프롬프트, 이미지, 기존 비디오 클립, 오디오 참조에서 AI 생성 비디오를 만드는 RESTful 엔드포인트를 제공합니다. API는 비동기 작업 기반 아키텍처를 사용합니다 — 생성 요청을 제출하면 작업 ID를 받고, 처리가 완료되면 결과를 폴링합니다.
텍스트 프롬프트만으로 비디오를 생성합니다. 해상도, 길이, 화면 비율, 스타일 매개변수를 지원합니다.
참조 이미지와 텍스트 프롬프트를 사용하여 정적 이미지를 비디오로 애니메이션화합니다. 시각적 스타일과 캐릭터 디테일을 보존합니다.
기존 비디오의 특정 요소를 수정합니다 — 피사체 교체, 오브젝트 추가 또는 제거, 영역 재페인트.
기존 비디오를 매끄러운 연속성과 일관된 스타일로 앞 또는 뒤로 확장합니다.
생성 작업의 상태를 확인하고, 완료 시 출력 비디오 URL을 가져옵니다.
상세한 텍스트 프롬프트로 시네마틱 품질의 비디오 클립을 생성합니다. 해상도(480P/720P), 프레임레이트(24fps), 길이(5-10초), 화면 비율(16:9, 9:16, 1:1)을 제어할 수 있습니다.
최대 7장의 참조 이미지를 업로드하여 비디오 생성을 가이드합니다. 모델은 참조 자료의 캐릭터 외형, 장면 구성, 시각적 스타일을 보존합니다.
프로그래밍 방식으로 기존 비디오를 편집합니다 — 피사체 교체, 오브젝트 추가/제거, 영역별 재페인트를 원본 모션과 카메라워크를 유지하면서 수행합니다.
매끄러운 전환으로 비디오를 어느 방향으로든 확장합니다. 순방향 생성은 선행 콘텐츠를 만들고, 트랙 완성은 공백을 채워 연속적인 스토리텔링을 구현합니다.
네이티브 오디오-비디오 생성으로 매칭된 효과음, 립싱크 대화, 배경 음악을 생성합니다. 다양한 억양의 다국어 음성을 지원합니다.
requests 라이브러리를 사용하여 텍스트-투-비디오 작업을 생성하고 결과를 폴링합니다.
import requests
import time
API_KEY = "your-api-key-here"
BASE_URL = "https://open.volcengineapi.com/api/v3/contents/generations/tasks"
# Step 1: Create a text-to-video generation task
response = requests.post(
f"{BASE_URL}/seedance/v2/text_to_video",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"prompt": "A young woman in a flowing red dress walks along a moonlit beach, gentle waves lapping at her feet. Smooth dolly-in, cinematic lighting, film grain.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9",
"fps": 24,
},
)
task = response.json()
task_id = task["data"]["task_id"]
print(f"Task created: {task_id}")
# Step 2: Poll for task completion
while True:
status_resp = requests.get(
f"{BASE_URL}/{task_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
)
status = status_resp.json()
state = status["data"]["status"]
if state == "completed":
video_url = status["data"]["output"]["video_url"]
print(f"Video ready: {video_url}")
break
elif state == "failed":
print(f"Generation failed: {status['data']['error']}")
break
else:
print(f"Status: {state}, waiting...")
time.sleep(10)작업 생성 및 상태 확인을 위한 커맨드라인 예제.
# Step 1: Create a text-to-video generation task
curl -X POST \
https://open.volcengineapi.com/api/v3/contents/generations/tasks/seedance/v2/text_to_video \
-H "Authorization: Bearer your-api-key-here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A young woman in a flowing red dress walks along a moonlit beach, gentle waves lapping at her feet. Smooth dolly-in, cinematic lighting, film grain.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9",
"fps": 24
}'
# Response: {"data": {"task_id": "task_abc123"}}
# Step 2: Check task status
curl -X GET \
https://open.volcengineapi.com/api/v3/contents/generations/tasks/task_abc123 \
-H "Authorization: Bearer your-api-key-here"
# Response when complete:
# {"data": {"status": "completed", "output": {"video_url": "https://..."}}}Fetch API를 사용하여 Seedance를 웹 애플리케이션에 통합.
const API_KEY = 'your-api-key-here';
const BASE_URL = 'https://open.volcengineapi.com/api/v3/contents/generations/tasks';
// Step 1: Create a text-to-video generation task
async function generateVideo(prompt) {
const response = await fetch(
`${BASE_URL}/seedance/v2/text_to_video`,
{
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt,
resolution: '720p',
duration: 5,
aspect_ratio: '16:9',
fps: 24,
}),
}
);
const task = await response.json();
const taskId = task.data.task_id;
console.log(`Task created: ${taskId}`);
// Step 2: Poll for task completion
while (true) {
const statusResp = await fetch(
`${BASE_URL}/${taskId}`,
{ headers: { 'Authorization': `Bearer ${API_KEY}` } }
);
const status = await statusResp.json();
const state = status.data.status;
if (state === 'completed') {
console.log(`Video ready: ${status.data.output.video_url}`);
return status.data.output.video_url;
} else if (state === 'failed') {
throw new Error(`Generation failed: ${status.data.error}`);
}
console.log(`Status: ${state}, waiting...`);
await new Promise((r) => setTimeout(r, 10000));
}
}
// Usage
generateVideo(
'A young woman in a flowing red dress walks along a moonlit beach, gentle waves lapping at her feet. Smooth dolly-in, cinematic lighting, film grain.'
).then((url) => console.log('Download:', url));Seedance 2.0 API 가격은 접근에 사용하는 플랫폼에 따라 다릅니다. 주요 옵션은 다음과 같습니다:
ByteDance의 공식 클라우드 플랫폼은 비디오 해상도, 길이, 생성 모드에 따른 종량제 가격을 제공합니다. 신규 계정에는 무료 체험 크레딧이 제공됩니다. Volcengine 계정 등록과 API 키 설정이 필요합니다.
Volcengine 가격 보기Vibbit의 사용자 친화적 인터페이스를 통해 API 설정 없이 Seedance 2.0에 접근하세요. 무료 플랜에는 모든 생성 모드의 체험 크레딧이 포함됩니다. 유료 플랜은 더 높은 할당량, 우선 생성, 상업 라이선스를 제공합니다.
Vibbit에서 무료 체험API 키, 폴링 로직, 인프라를 다루고 싶지 않으신가요? Vibbit은 간단한 브라우저 인터페이스로 Seedance 2.0의 모든 기능에 접근할 수 있게 해줍니다. 프롬프트를 입력하고, 생성을 클릭하면 몇 분 안에 비디오를 다운로드할 수 있습니다.
Seedance 2.0 API는 ByteDance가 Volcengine 클라우드 플랫폼을 통해 제공하는 RESTful 인터페이스입니다. 개발자가 텍스트 프롬프트, 이미지, 비디오 클립, 오디오 참조에서 프로그래밍 방식으로 AI 비디오를 생성할 수 있습니다. 텍스트-투-비디오, 이미지-투-비디오, 비디오 편집, 비디오 확장, 작업 상태 조회를 지원합니다.
공식 API를 사용하려면 Volcengine(volcano.engine)에서 계정을 만들고, AI 콘텐츠 생성 서비스로 이동하여 API 키를 생성하세요. 또는 Vibbit(app.vibbit.ai)을 사용하면 API 설정 없이 Seedance 2.0에 접근할 수 있습니다 — 가입만 하면 바로 생성을 시작할 수 있습니다.
가격은 플랫폼에 따라 다릅니다. Volcengine은 해상도, 길이, 생성 모드에 따른 종량제 가격을 제공하며, 신규 사용자에게는 무료 체험 크레딧이 있습니다. Vibbit은 체험 크레딧이 포함된 무료 플랜과 더 많은 사용량을 위한 유료 구독 플랜을 제공합니다.
속도 제한은 계정 등급과 플랫폼에 따라 다릅니다. Volcengine은 구독 수준에 따라 분당 및 일일 할당량을 설정합니다. 각 비디오 생성 요청은 비동기식입니다 — 작업을 제출하고 완료를 폴링하며, 일반적으로 비디오당 1-3분이 소요됩니다.
네! Vibbit은 코드를 작성하지 않고도 Seedance 2.0의 모든 기능에 접근할 수 있는 브라우저 기반 인터페이스를 제공합니다. app.vibbit.ai를 방문하여 프롬프트를 입력하고, 필요한 경우 참조 미디어를 업로드한 다음 생성을 클릭하면 됩니다. 비개발자가 Seedance 2.0을 사용하는 가장 쉬운 방법입니다.