Seedance 2.0 API: 개발자를 위한 실용 가이드

최종 업데이트: 2026년 3월

Seedance 2.0 API를 사용하면 개발자가 AI 비디오 생성을 애플리케이션에 직접 통합할 수 있습니다. 이 가이드는 API의 실제 기능, 대안과의 비교, 그리고 시작 방법을 다룹니다.

Seedance 2.0 API의 기능

Seedance 2.0 API는 텍스트 프롬프트와 이미지에서 비디오를 생성할 수 있는 프로그래밍 방식의 액세스를 제공합니다. 웹 인터페이스를 사용하는 대신 HTTP 요청을 통해 생성 작업을 제출하고, 완료를 폴링하며, 비디오 URL을 검색합니다.

핵심 기능:

• 텍스트-투-비디오 생성 (Seedance 2.0 모델)
• 이미지-투-비디오 생성 (참조 이미지 애니메이션)
• 비동기 작업 제출 및 상태 폴링
• MP4 형식, 1080p HD 출력
• 생성당 최대 약 10초

제공하지 않는 기능:

• 실시간 스트리밍 출력 없음 (생성에 시간 소요)
• 내장 비디오 편집 기능 없음
• 오디오 생성 없음 (Google Veo 3와 달리)
• 부하에 따라 생성 대기 시간 변동

Seedance API vs 경쟁 API

구축하기 전에 옵션을 솔직하게 비교하는 것이 좋습니다.

Seedance API가 적합한 경우:

• Google Cloud 설정 복잡성 없이 좋은 품질을 원할 때
• 신뢰할 수 있는 크레딧 기반 가격이 필요한 제품을 구축할 때
• 하나의 API에서 여러 모델에 액세스하려 할 때 (Seedance 1.5는 속도, 2.0은 품질)

대안을 고려해야 할 경우:

• 최고 품질이 필요할 때 → Google Veo 3 (Vertex AI)
• 기본 오디오 생성이 필요할 때 → Google Veo 3
• 고급 카메라 제어가 필요할 때 → Runway API

시작하기

1단계: API 키 받기

seedance.tv에 가입하고 계정 설정으로 이동하세요. API 액세스는 월 $9.9부터 시작하는 유료 요금제에서 사용할 수 있습니다.

API 키를 환경 변수로 저장하세요. 소스 파일에 하드코딩하지 마십시오:

export SEEDANCE_API_KEY="your-api-key-here"

2단계: 생성 작업 제출

API는 비동기 패턴을 사용합니다: 작업을 제출하고 완료를 폴링합니다.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.seedance.tv/v1"

def generate_video(prompt: str, model: str = "seedance-2.0"):
    """텍스트-투-비디오 생성 작업을 제출합니다."""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": model,
            "aspect_ratio": "16:9",
            "resolution": "1080p"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

3단계: 완료 폴링

def wait_for_completion(job_id: str, poll_interval: int = 5, timeout: int = 300):
    """비디오 생성이 완료될 때까지 폴링합니다."""
    start_time = time.time()
    
    while time.time() - start_time < timeout:
        response = requests.get(
            f"{BASE_URL}/videos/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        response.raise_for_status()
        data = response.json()
        
        status = data["status"]
        
        if status == "completed":
            return data["output_url"]
        elif status == "failed":
            raise Exception(f"생성 실패: {data.get('error', '알 수 없는 오류')}")
        
        # 아직 처리 중
        print(f"상태: {status} ({int(time.time() - start_time)}초 경과)")
        time.sleep(poll_interval)
    
    raise TimeoutError(f"{timeout}초 내에 생성이 완료되지 않았습니다.")

# 사용 예
job_id = generate_video("느린 돌리 샷, 네온 불빛이 비추는 밤 도쿄 거리, 젖은 포장도로에 비 반사, 시네마틱 1080p")
video_url = wait_for_completion(job_id)
print(f"비디오 준비 완료: {video_url}")

4단계: 이미지-투-비디오

참조 이미지를 애니메이션화하려면:

def generate_from_image(image_url: str, prompt: str):
    """참조 이미지를 애니메이션화합니다."""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": "seedance-2.0",
            "image_url": image_url,
            "type": "image-to-video",
            "aspect_ratio": "16:9"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

API용 프롬프트 엔지니어링

출력 품질은 프롬프트 구조에 크게 의존합니다. 다음은 일관되게 작동하는 패턴입니다:

좋은 텍스트-투-비디오 프롬프트 구조:

[샷 유형], [주제 설명], [동작/움직임], [환경], [조명], [스타일]

예시:

클로즈업 트래킹 샷, 햇살 가득한 올리브 숲을 걷는 여성, 바람에 흩날리는 머리카락, 나뭇잎 사이로 따뜻한 오후 햇빛, 시네마틱 얕은 심도

API 크레딧을 낭비하는 일반적인 실수:

너무 모호함:

아름다운 비디오

너무 많은 경쟁 요소:

해변에 남자와 여자와 개, 그리고 일몰과 파도와 배경의 산

동작 설명 누락:

테이블 위의 커피잔

더 나은 예: 나무 테이블 위의 커피잔, 천천히 올라가는 증기, 왼쪽에서 들어오는 부드러운 자연광, 매크로 렌즈

적절한 모델 선택:

권장 워크플로: seedance-1.5로 초안 작성, 프롬프트 개선, 그런 다음 seedance-2.0으로 최종 생성. 이렇게 하면 반복 중 API 비용이 절감됩니다.

화면 비율

ASPECT_RATIOS = {
    "landscape": "16:9",   # YouTube, 데스크톱, 광고
    "portrait": "9:16",    # TikTok, Instagram Reels, Shorts
    "square": "1:1",       # Instagram 게시물
    "cinema": "21:9"       # 시네마틱 와이드스크린
}

오류 처리

def safe_generate(prompt: str, max_retries: int = 3):
    """일시적 오류에 대한 재시도 로직으로 생성합니다."""
    for attempt in range(max_retries):
        try:
            job_id = generate_video(prompt)
            return wait_for_completion(job_id)
        except requests.HTTPError as e:
            if e.response.status_code == 429:
                # 속도 제한 — 백오프
                wait = 30 * (attempt + 1)
                print(f"속도 제한됨. {wait}초 대기 중...")
                time.sleep(wait)
            elif e.response.status_code == 402:
                raise Exception("크레딧이 부족합니다. seedance.tv에서 계정을 충전하세요.")
            else:
                raise
        except TimeoutError:
            if attempt < max_retries - 1:
                print(f"{attempt + 1}번째 시도 시간 초과, 재시도 중...")
            else:
                raise
    raise Exception("최대 재시도 횟수 초과")

속도 제한 및 크레딧 사용

• 속도 제한: 요금제에 따라 다릅니다. 현재 제한은 대시보드에서 확인하세요.
• 생성당 크레딧: 모델, 지속 시간 및 해상도에 따라 다릅니다. 대시보드에 실시간 크레딧 잔액이 표시됩니다.
• 프로덕션 모범 사례: 많은 동시 요청을 제출하는 대신 작업 큐를 구현하세요. 단계적 제출은 속도 제한 오류를 피하고 비용 효율적입니다.

이 API에 적합한 사용 사례

제품 비디오 자동화: 제품 이미지에서 대규모로 비디오를 생성하는 전자상거래 플랫폼. 제품 이미지 + 브랜드 음성 프롬프트를 입력하여 각 SKU에 대한 자동 비디오 클립 생성.

소셜 미디어 파이프라인: 승인된 프롬프트 목록에서 한 주 분량의 비디오 콘텐츠를 생성하는 예약 콘텐츠 시스템. 비디오 큐 도구와 결합하여 자동 게시.

광고 크리에이티브 테스트: 동일한 개념에 대한 여러 시각적 해석을 생성하여 A/B 테스트하는 마케팅 도구. 한 배치에서 광고 개념의 5가지 변형 생성.

프로토타입 생성: 프로덕션에 투입하기 전에 개념 비디오를 생성하는 디자인 및 제품 팀. 초기 단계 시각화를 위해 전통적인 프로덕션보다 훨씬 저렴.

간단한 비디오 생성 파이프라인 구축

import json
from pathlib import Path

def batch_generate(prompts: list[dict], output_dir: str = "./videos"):
    """프롬프트 구성 목록에서 여러 비디오를 생성합니다."""
    Path(output_dir).mkdir(exist_ok=True)
    results = []
    
    for i, config in enumerate(prompts):
        print(f"생성 중 {i+1}/{len(prompts)}: {config['name']}")
        
        try:
            # 초안에는 빠른 모델, 최종에는 프리미엄 모델 사용
            model = "seedance-2.0" if config.get("final") else "seedance-1.5"
            job_id = generate_video(config["prompt"], model=model)
            url = wait_for_completion(job_id)
            
            results.append({
                "name": config["name"],
                "url": url,
                "status": "success"
            })
            print(f"  ✓ {url}")
            
        except Exception as e:
            results.append({
                "name": config["name"],
                "error": str(e),
                "status": "failed"
            })
            print(f"  ✗ 실패: {e}")
        
        # 제출 간 짧은 지연
        time.sleep(2)
    
    # 결과 저장
    with open(f"{output_dir}/results.json", "w") as f:
        json.dump(results, f, indent=2)
    
    return results

# 사용 예
prompts = [
    {"name": "hero-shot", "prompt": "...", "final": True},
    {"name": "product-demo", "prompt": "...", "final": False},
]
results = batch_generate(prompts)

자주 묻는 질문

Seedance 2.0에 공식 공개 API가 있나요?

Seedance는 유료 요금제의 일부로 API 액세스를 제공합니다. 현재 액세스 세부 정보 및 엔드포인트 사양은 seedance.tv의 개발자 문서를 확인하세요.

가격은 어떻게 작동하나요?

API 사용은 크레딧 잔액에서 차감됩니다. 모델마다 생성당 크레딧 비용이 다릅니다. 모델별 현재 크레딧 요금은 대시보드에서 확인하세요.

비디오당 생성 시간은 얼마인가요?

일반적으로 모델 복잡성과 큐 부하에 따라 30초에서 3분입니다. Seedance 1.5는 더 빠르고, Seedance 2.0은 더 오래 걸리지만 더 높은 품질을 제공합니다.

10초보다 긴 비디오를 생성할 수 있나요?

현재 단일 API 호출로는 불가능합니다. 더 긴 콘텐츠의 경우 여러 클립을 생성하고 moviepy 또는 ffmpeg와 같은 비디오 처리 라이브러리를 사용하여 애플리케이션에서 연결하세요.

출력물을 상업적으로 사용할 수 있나요?

상업적 라이선스 세부 정보는 seedance.tv의 현재 서비스 약관을 확인하세요. 일반적으로 유료 요금제에서 생성된 콘텐츠는 상업적 사용이 허가됩니다.

Seedance API와 Runway API를 비교하면 어떤가요?

Runway API($0.05-0.10/초)는 더 고급 카메라 제어와 Gen-3 Alpha 모델을 제공합니다. Seedance API는 크레딧 기반 가격을 사용하므로 예산 계획에 더 예측 가능합니다. Runway는 시네마틱 폴리시와 카메라 제어에서 우위를 점하고, Seedance는 모델 다양성과 가격 명확성에서 우위를 점합니다. 대부분의 개발자에게 특정 사용 사례에서 두 가지를 모두 시도해 보세요. 결과는 콘텐츠 유형에 따라 크게 다릅니다.

---

구축 시작하기

AI 비디오를 애플리케이션에 통합할 준비가 되셨나요?

Seedance에 가입하기 → — API를 테스트할 무료 크레딧을 받고, 월 $9.9부터 시작하는 유료 요금제를 이용하세요.

• 텍스트-투-비디오 플레이그라운드 — 구축 전 프롬프트 테스트
• 이미지-투-비디오 플레이그라운드 — 이미지 애니메이션 테스트
• Seedance 2.0 모델 세부 정보 — 품질 벤치마크 및 사양