Seedance 2.0 API는 어떻게 사용하나요? 5분 만에 첫 영상 생성하기

TL;DR

• Seedance 2.0은 바이트댄스의 영상 생성 모델로, HiAPI에서 Mini, Fast, 표준 버전 세 가지로 제공되며, 모델 페이지를 열면 바로 온라인으로 생성할 수 있고, 신규 가입 시 200 크레딧을 지급합니다.
• 초 단위 과금: Mini 720p 초당 $0.0586, 표준 버전 720p 초당 $0.293, 1080p는 ext 라인으로 초당 $0.342이며, 사운드는 추가 비용이 없습니다.
• API는 단 두 단계: POST /v1/tasks로 제출하고, taskId로 결과를 조회합니다. 아래 curl과 Python은 복사해서 바로 실행할 수 있습니다.

Seedance 2.0으로 무엇을 할 수 있나요?

• 텍스트 투 비디오: 4–15초, 480p에서 4K까지, 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 여섯 가지 화면 비율, 이미지 투 비디오는 adaptive로 원본 이미지를 따라갈 수도 있습니다.
• 이미지 투 비디오: 첫 프레임(first_frame_url)을 전달하고, 마지막 프레임(last_frame_url)을 추가해 종료 화면을 제어할 수 있습니다.
• 멀티모달 참고: 최대 9장의 참고 이미지, 3개의 참고 영상, 3개의 참고 오디오로 인물, 카메라 무브, 리듬을 고정할 수 있습니다.
• 네이티브 사운드: generate_audio는 기본 활성화되어 환경음과 효과음이 화면과 동기화되어 생성됩니다.

아래 5초 720p 제품 클로즈업 장면은 프롬프트 한 줄로 바로 생성한 것입니다:

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

이 프롬프트로 생성하기 →

두 가지 시작 방법

온라인 체험(코딩 없이)

1. Seedance 2.0 모델 페이지를 열고 가입하거나 로그인합니다.
2. 프롬프트를 붙여넣고 길이, 해상도, 화면 비율을 선택합니다.
3. 생성을 클릭하고 결과가 나오면 바로 다운로드합니다(가격 페이지의 5초 720p 라테 샘플 3건은 제출부터 완료까지 168–230초가 걸렸습니다).

API 호출

1. 콘솔에서 API Key를 생성합니다.
2. POST https://api.hiapi.ai/v1/tasks로 작업을 제출하면 taskId가 반환됩니다.
3. GET /v1/tasks/{taskId}로 상태를 조회하고, status가 success이면 output[0].url에서 영상을 다운로드합니다.

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",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

반환:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

결과 조회:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

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(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **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)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

프롬프트를 조정할 때는 model을 seedance-2.0-mini로, 해상도를 480p로 바꾸면 5초에 $0.136밖에 들지 않습니다. 최종 확정 후 표준 버전이나 ext 라인으로 고화질을 생성하세요.

이미지 투 비디오와 멀티모달 참고

첫 프레임 이미지 투 비디오: input에 first_frame_url을 추가하고, 화면 비율을 adaptive로 쓰면 이미지 비율을 따라갑니다:

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

참고 이미지, 참고 영상, 참고 오디오: 각각 reference_image_urls(참고 이미지와 첫·마지막 프레임 합계 최대 9장), reference_video_urls(최대 3개, 합계 15초 이내), reference_audio_urls(최대 3개, 합계 15초 이내)를 사용합니다.

Mini의 입력 조합: Mini는 첫 프레임, 참고 이미지, 참고 영상 중 하나를 선택하며, duration과 resolution은 필수입니다. 표준 버전은 aspect_ratio가 필수입니다.

ext 라인: 최상위에 "route": "ext"를 추가하고 모델명은 그대로 둡니다. ext는 720p, 1080p, 4K만 지원하며 초당 비용이 더 저렴하지만 참고 영상은 받지 않습니다.

출시 전 유의 사항

• 폴링 대신 콜백 사용: 요청 최상위에 "callback": {"url": "https://你的도메인/hiapi/callback"}를 추가하면 작업이 종료(성공 또는 실패)될 때 HiAPI가 능동적으로 알려줍니다. taskId로 중복 제거하세요.
• 영상은 기본 약 7일간 보관: output[0].url을 받은 후 자체 스토리지로 전송하세요. 장기 보관이 필요하면 HiAPI의 영구 스토리지를 사용할 수 있습니다(저장량에 따라 별도 과금).
• 파라미터를 모두 작성: duration, resolution, aspect_ratio를 모두 명시해야 비용이 예산표와 맞습니다.
• 실패 시 자동 환불: 실패한 작업은 과금되지 않으며, 성공적으로 생성된 초수만 과금됩니다.

자주 묻는 질문

Mini, Fast, 표준 버전 중 어떻게 선택하나요?

프롬프트 조정에는 Mini, 소셜 숏폼 영상에는 Mini 또는 Fast 720p, 1080p / 4K가 필요하면 표준 버전이나 ext 라인을 사용하세요. 자세한 가격은 Seedance 2.0 API 가격을 참고하세요.

프롬프트를 중국어로 작성할 수 있나요?

네. 중국어와 영어 모두 지원하며, 카메라, 동작, 조명, 사운드를 문장으로 나누어 명확히 작성하면 가장 안정적입니다.

세로 영상을 생성할 수 있나요?

네. aspect_ratio에 9:16을 작성하고, 이미지 투 비디오는 adaptive로 첫 프레임 비율을 따라가게 하세요.

영상 하나에 얼마나 걸리나요?

가격 페이지의 5초 720p 라테 샘플 3건은 제출부터 완료까지 168–230초가 걸렸습니다. 프로덕션 환경에서는 콜백으로 결과를 받고, 고정 대기 시간에 의존하지 마세요.

위의 스마트워치 프롬프트를 복사해서 모델 페이지에서 첫 영상을 생성하세요; 더 많은 기성 프롬프트를 원하면 Seedance 2.0 프롬프트 사례를 참고하세요.