Seedance 2.0 Mini API 한국어 튜토리얼: 초당 $0.0272의 비디오 인터페이스

TL;DR

• seedance-2.0-mini는 바이트댄스 Seedance 2.0의 경량 버전입니다. 하나의 모델 이름으로 텍스트 투 비디오, 이미지 투 비디오(첫 프레임 또는 첫/마지막 프레임), 레퍼런스 투 비디오를 모두 할 수 있으며 동기화된 사운드가 기본 포함됩니다. 모델 페이지 열기에서 온라인으로 생성할 수 있고, 신규 사용자 가입 시 200 크레딧을 드립니다.
• HiAPI에서 가장 저렴한 비디오 모델 중 하나입니다: 480p 초당 $0.0272, 720p 초당 $0.0586. 5초 480p는 단 $0.136입니다.
• resolution은 필수 항목이며, 전달하지 않으면 바로 오류가 발생합니다. 아래에 curl 및 Python 예제, 전체 파라미터, 그리고 세 가지 모드 각각의 요금 계산 방법을 제시합니다.

먼저 결과 보기

텍스트 투 비디오 세 편, 모두 5초 480p, 각 $0.136.

A slow dolly-in toward a steaming bowl of ramen on a worn wooden counter in a dim izakaya. Warm amber lantern light, soft volumetric haze, gentle steam curling upward, shallow depth of field, the broth surface rippling slightly. Cinematic, photoreal.

이 프롬프트로 생성 → (5초, 480p)

seedance-2.0-mini, 텍스트 투 비디오, 480p, 5초, $0.136.

A cozy fireplace crackling in a log cabin at night, orange embers popping and drifting, a cast-iron kettle gently steaming on the hearth, rain streaking the dark window behind. Static locked-off shot. Native audio: crackling fire, soft rain on glass, a low wind.

이 프롬프트로 생성 → (5초, 480p)

seedance-2.0-mini, 텍스트 투 비디오, 480p, 5초, 네이티브 사운드 포함, $0.136.

이 영상의 장작 타는 소리, 빗소리, 바람 소리는 프롬프트 마지막 문장에서 나온 것입니다. Mini는 기본으로 사운드를 생성하지만, 구체적으로 어떤 소리가 나올지는 프롬프트에 명확히 써야 합니다.

A border collie sprints across a sunlit beach toward the camera, kicking up wet sand, ears flapping, tongue out, water spray catching the low golden light. Tracking shot moving backward to keep the dog centered, motion blur on the paws, joyful energy, photoreal.

이 프롬프트로 생성 → (5초, 480p)

seedance-2.0-mini, 텍스트 투 비디오, 480p, 5초, $0.136.

curl: 첫 번째 영상

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-mini",
    "input": {
      "prompt": "비 내리는 밤 네온 사이버펑크 거리, 카메라가 천천히 다가가며, 젖은 노면에 반사된 화려한 빛, 영화 같은 분위기",
      "resolution": "480p",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5초 480p, $0.136. data.taskId가 반환되면, GET /v1/tasks/{taskId}로 status가 success인지 확인한 뒤 output[0].url을 다운로드합니다.

Python: 제출, 폴링, 다운로드

# pip install requests；먼저 export HIAPI_KEY=당신의 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "seedance-2.0-mini", "input": params}
    # 같은 작업을 재제출할 때는 같은 Idempotency-Key를 사용해 중복 과금을 방지
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 이미지 투 비디오: 한 장의 이미지를 움직이게 하기, 720p 5초 ($0.293)
url = generate(
    prompt="카메라가 천천히 멀어지며, 구름과 안개가 봉우리 사이로 흐르고, 황금빛 아침 햇살",
    first_frame_url="https://your-cdn.example.com/first-frame.jpg",
    resolution="720p", duration=5, generate_audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

하나의 모델, 세 가지 모드

어떤 파라미터를 전달하느냐에 따라 모드가 결정됩니다:

모드	전달할 것	설명
텍스트 투 비디오	prompt만 전달
이미지 투 비디오	first_frame_url, 선택적으로 last_frame_url 추가	레퍼런스 이미지, 레퍼런스 비디오와 혼용 불가
레퍼런스 투 비디오	reference_image_urls, reference_video_urls, reference_audio_urls	레퍼런스 비디오, 레퍼런스 오디오 각각 최대 3개, 각각 총 길이 15초 이하

파라미터 일람

파라미터	값	설명
prompt	문자열, 필수	중국어와 영어 모두 가능
resolution	480p / 720p, 필수	전달하지 않으면 400 반환
duration	4–15의 정수, 필수(예제에서는 5 사용)	단위 초
aspect_ratio	1:1 4:3 3:4 16:9 9:16 21:9 adaptive, 기본 16:9
generate_audio	기본 true	네이티브 동기화 사운드
first_frame_url / last_frame_url	이미지 주소	jpeg/png/webp/bmp/tiff/gif, 변 길이 300–6000 px, 장당 30 MB 미만
reference_image_urls	이미지 주소	첫/마지막 프레임과 합산 최대 9장
reference_video_urls	최대 3개	mp4/mov, 480p 또는 720p, 개당 2–15초, 합산 15초 이하
reference_audio_urls	최대 3개	wav/mp3, 개당 2–15초, 합산 15초 이하

요금 계산

길이	480p ($0.0272/초)	720p ($0.0586/초)
4초	$0.1088	$0.2344
5초	$0.136	$0.293
10초	$0.272	$0.586
15초	$0.408	$0.879

reference_video_urls를 전달하면 다른 단가로 청구됩니다: 480p 초당 $0.0172, 720p 초당 $0.0358. $10으로 480p에서 약 367초를 생성할 수 있습니다. 먼저 480p로 프롬프트를 조정하고, 확정된 후에 720p로 출력하는 것을 권장합니다. 1080p가 필요하면 Seedance 2.0 또는 Seedance 2.5로 전환하세요.

출시 전 주의사항

• 폴링 대신 콜백 사용: 요청 최상위(input과 같은 레벨)에 "callback": {"url": "https://당신의-도메인/hiapi/callback"}를 추가하고, taskId로 중복을 제거하세요.
• 즉시 전송/저장: output[0].url은 임시 링크입니다.
• 재시도 시 멱등 키 사용: 요청 헤더에 Idempotency-Key를 추가하면, 같은 키로 재시도해도 작업이 한 번만 생성됩니다.
• 실패 시 자동 환불: 성공적으로 생성된 비디오에 대해서만 과금됩니다.

자주 묻는 질문

Seedance 2.0 Mini와 Seedance 2.0 중 어떻게 선택해야 하나요?

480p에서 Mini의 가격은 2.0의 약 5분의 1(초당 $0.0272 대 $0.136)이지만, 최대 720p까지만 지원합니다. 초안 작성, 소셜 미디어 숏폼 대량 제작, 프롬프트 테스트에는 Mini를 사용하고, 1080p 또는 4K가 필요하면 Seedance 2.0으로 전환하세요.

resolution을 전달하지 않으면 왜 오류가 발생하나요?

이 모델의 resolution은 필수 항목이며, "480p" 또는 "720p"를 명시적으로 작성해야 합니다.

사운드가 있나요?

기본으로 있습니다. 프롬프트에 원하는 사운드를 명확히 작성하세요. 사운드가 필요 없으면 generate_audio를 false로 설정하세요.

한 편의 최대 길이는 얼마인가요?

4초에서 15초입니다.

더 많은 작성 방법을 보려면 Seedance 2.0 프롬프트 가이드를 참고하세요. 또는 모델 페이지에서 라멘 영상을 직접 생성할 수 있습니다.