가이드 목록으로
비디오·2026년 7월 2일·최종 업데이트 2026년 9월 30일·7분 분량

Seedance API 사용 방법 — 가격 및 Python 구현(Seedance 2 지원·2026)

ByteDance의 동영상 생성 모델 Seedance 2를 OpenAI 호환 API로 직접 호출하는 방법입니다. 가격표, Python 코드, Fast 사용 구분 및 Veo 3.1과의 비교까지 프로덕션 도입에 필요한 정보를 정리했습니다.

Seedance는 ByteDance의 텍스트-동영상 생성 제품군이며, 최신 세대인 Seedance 2는 네이티브 오디오·멀티샷 구성·참조 이미지 일관성을 갖춘 2026년 주목 모델입니다. Seedance API는 Kunavo에서 운영 중이며, OpenAI 호환 엔드포인트, USD 기준 초 단위 과금, Volcano Engine 계정 불필요라는 특징을 제공합니다.

Seedance API 요금

과금은 생성된 동영상의 초 단위이며 해상도별로 다릅니다:

모델해상도Kunavo5초 클립
Seedance 2 Fast480p$0.093 / 초$0.47
720p$0.198 / 초$0.99
Seedance 2480p$0.114 / 초$0.57
720p$0.246 / 초$1.23
1080p$0.612 / 초$3.06

청구는 USD 기준 클립 단위로 이루어지며, 선불 충전한 Stripe 잔액에서 차감됩니다. 크레딧 번들을 환산할 필요가 없습니다. 요금은 요금 페이지와 동일한 소스에서 표시됩니다.

사용 방법 — 텍스트로 동영상 생성하기

POST /v1/video/generations에 프롬프트를 보내기만 하면 됩니다. 검증에는 seedance-2-fast, 프로덕션 애셋에는 seedance-2를 권장합니다:

seedance_t2v.py
import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "seedance-2-fast",   # 最高品質は "seedance-2"
        "prompt": "折り鶴がほどけて鳥の群れになる、マクロ撮影、朝の柔らかい光",
        "duration": 5,
        "aspect_ratio": "16:9",
        "resolution": "720p",         # Fast: 480p/720p、Seedance 2 は 1080p も可
    },
    timeout=600,  # 生成には数分かかることがあります
)
print(resp.json()["data"][0]["url"])

생성에는 몇 분이 걸립니다. 프로덕션에서는 비동기 /v1/videos 작업 흐름을 사용하고, Idempotency-Key를 붙여 재시도하더라도 이중 과금되지 않도록 하세요.

이미지에서 동영상으로(image-to-video)

image_url를 전달하면 정지 이미지가 첫 프레임이 됩니다. 참조 일관성은 Seedance의 핵심 강점입니다:

seedance_i2v.py
# 画像から動画へ: image_url を渡すと、その静止画が最初のフレームになります。
resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "seedance-2",
        "prompt": "商品がゆっくり回転し、スタジオライトが表面を滑る",
        "image_url": "https://example.com/product-hero.png",
        "duration": 5,
        "resolution": "720p",
    },
    timeout=600,
)

Seedance 2와 Fast의 구분

Fast는 같은 제품군의 대량 생성용 모델입니다. 지연 시간이 짧고 약 20% 저렴하며 720p가 상한이므로 SNS용 및 대량 생성 파이프라인에 적합합니다. Seedance 2는 1080p와 멀티샷 일관성이 필요한 주요 애셋에 적합합니다. 요청 형식은 동일하므로 전환은 model 한 단어만 변경하면 됩니다.

Veo 3·Wan과의 비교

모두 동일한 엔드포인트에서 작동합니다. 스토리텔링과 참조 일관성이 중요하면 Seedance 2, 종합적인 품질과 네이티브 오디오가 중요하면 Veo 3(Lite $0.18/개), 가장 저렴한 시네마틱 영상이 필요하면 Wan 2.7($0.096/초)를 선택하세요. 전체 내용은 text-to-video API 가이드를 참조하세요.

자주 묻는 질문

Seedance API란 무엇인가요?

Seedance는 ByteDance의 텍스트-동영상 생성 모델 제품군이며, 최신 세대인 Seedance 2는 네이티브 오디오, 멀티샷 구성, 참조 이미지 일관성이 강점입니다. Kunavo에서는 seedance-2와 seedance-2-fast가 OpenAI 호환 /v1/video/generations 엔드포인트에서 작동합니다.

Seedance API의 요금은 얼마인가요?

Kunavo에서는 생성된 초 단위로 과금합니다. Seedance 2 Fast는 480p에서 초당 $0.093, 720p에서 초당 $0.198이며, Seedance 2는 480p에서 초당 $0.114, 720p에서 초당 $0.246, 1080p에서 초당 $0.612입니다. 5초 720p 클립은 Fast에서 $0.99, Seedance 2에서 $1.23이며, 실패한 생성에는 비용이 청구되지 않습니다.

Volcano Engine 계정이 필요한가요?

필요하지 않습니다. Kunavo의 sk-kn- 키 하나와 Stripe 잔액만으로 Seedance뿐 아니라 Veo 3, Wan 2.7, 이미지 모델, Suno, Claude / GPT까지 동일한 OpenAI 호환 API로 호출할 수 있습니다.

Seedance와 Veo 3 중 어느 것을 사용해야 하나요?

Seedance 2는 멀티샷 스토리텔링과 캐릭터 일관성이, Veo 3는 전반적인 영상 품질과 네이티브 동기화 오디오가 강점입니다. 둘 다 동일한 엔드포인트에서 작동하므로 model 필드의 한 단어만 변경해 A/B 테스트할 수 있습니다.