HiAPI
블로그

사용 가이드

Seedance 2.0@ext 숏폼 비디오: 소셜 숏폼을 위한 실용 API 워크플로

seedance-2.0@ext 비동기 작업 API로 상세 프롬프트 한 줄을 세로형 오디오 포함 완성 영상으로 만들기

Aug 10, 2026
Seedance 2.0@ext 숏폼 비디오: 소셜 숏폼을 위한 실용 API 워크플로

오늘날 대부분의 소셜 콘텐츠 발견은 숏폼 비디오에서 일어나며, 깔끔한 세로형 단편 하나를 만들려면 촬영과 편집, 혹은 둘 다 필요합니다. hiapi의 seedance-2.0@ext는 이런 단계를 건너뜁니다. 상세 프롬프트를 작성하고 API 엔드포인트를 한 번 호출하면 몇 분 후 완성된 9:16 비디오가 오디오까지 포함된 채로 돌아옵니다.

이 실전 가이드는 실제로 생성한 단편 하나를 통해 워크플로 전체를 처음부터 끝까지 설명합니다. 프롬프트가 어떻게 구성되는지, 비동기 작업 API 호출이 실제로 어떻게 쓰이는지, 비용이 얼마였는지, 그리고 가격이 어디서 기대와 어긋나는지까지 다룹니다.

숏폼 비디오에 seedance-2.0@ext를 쓰는 이유

seedance-2.0@ext는 hiapi의 seedance-2.0 모델 패밀리에서 ext 라우트입니다. 독자적인 가격과 파라미터 세트를 가진 별도 라우트로, 기본 seedance-2.0 라우트와 다릅니다. 세로형 소셜 네이티브 출력을 위해 만들어졌습니다. 네이티브 9:16 구도, 휴대폰 화면에서 보기 좋은 카메라 무빙, 그리고 사후에 덧붙이는 것이 아니라 비디오와 같은 생성 과정에서 함께 만들어지는 오디오가 특징입니다.

이 조합, 즉 세로형 구도에 네이티브 오디오가 더해진 것이 TikTok과 Reels 스타일 단편에 적합한 이유입니다. 범용 비디오 모델로 만든 뒤 직접 자르고 음악을 입히는 방식과는 다릅니다.

프롬프트: 이 단편이 실제로 사용한 것

이 글을 위해 데모 단편 하나를 처음부터 끝까지 생성했습니다. 얼음이 가득 찬 유리잔에 콜드브루 커피가 따라지는 세로형 제품 클로즈업으로, 소셜 피드에 맞춘 스타일입니다. 아래는 실제 출력물과 그것을 생성한 원본 프롬프트입니다.

소셜 피드를 위한 세로형 9:16 제품 클로즈업 쇼케이스: 햇빛이 비치는 대리석 조리대 위 중앙에 놓인 무광 유리잔. 빈 잔 위에서 천천히 위에서 아래로 카메라가 푸시인하며, 잔에는 투명한 얼음이 가득 차 골든 아워 빛을 반사한다. 2초 지점에서 화면 밖 위쪽에서 콜드브루 커피가 따라져 소용돌이치며 얼음을 어둡게 만들고, 이어서 우유가 부드러운 나선 문양으로 스며든다. 물방울이 유리를 타고 흘러내리고, 역광 속에서 냉기가 위로 피어오른다. 카메라는 톱다운에서 천천히 아크를 그리며 로우 앵글 4분의 3 정면 뷰로 이동하고, 마지막에는 배경 창밖으로 따뜻한 보케가 비치는 선명한 얕은 심도 클로즈업으로 끝난다. 밝은 자연 상업 조명, 광택 반사, 얕은 심도, 초깔끔한 제품 비디오 미학, 부드러운 핸드헬드 미세 움직임, 고급 상업 질감. 네이티브 오디오: 부드러운 따르는 물소리, 유리에 부딪히는 얼음 소리, 은은한 카페 환경 소음, 음악 없음. 읽을 수 있는 텍스트 없음, 로고 없음, 사람 없음, 손 없음, 편집 없음.

결과: 720×1280(9:16), 24fps, 약 8초, 파일에 네이티브 AAC 스테레오 오디오가 내장되어 있어 별도의 폴리(Foley) 작업이 필요 없습니다.

이 프롬프트가 효과적인 이유

이 프롬프트는 더 짧고 모호한 프롬프트가 하지 못하는 몇 가지를 해냅니다.

  • 카메라에 단일 화면이 아니라 경로를 부여합니다. "톱다운 푸시인" → "천천히 아크를 그리며 로우 앵글 4분의 3 정면 뷰로 이동" → "선명한 클로즈업"은 정지된 구도가 아니라 단편 전체를 관통하는 움직임을 묘사합니다.
  • 동작에 시간을 정합니다. "2초 지점에서 콜드브루 커피가 따라져"는 따라지는 동작을 구체적인 시점에 고정합니다. 모델이 "재미있는 부분"이 언제 일어나야 하는지 추측하게 두지 않습니다.
  • 재질과 빛의 단서를 겹쳐 놓습니다. 물방울, 냉기, 따뜻한 보케, 광택 반사 같은 디테일이 제품 샷을 평범함에서 고급스러움으로 끌어올립니다.
  • 오디오를 사후 보충이 아니라 프롬프트에 직접 씁니다. 따르는 물소리, 얼음 부딪히는 소리, 환경 소음을 명시하고 음악은 넣지 말라고 분명히 합니다. 모델은 위에서 묘사한 시각적 동작과 사운드를 동기화합니다.
  • 부정 목록으로 마무리합니다. "읽을 수 있는 텍스트 없음, 로고 없음, 사람 없음, 손 없음, 편집 없음"은 제품 생성에서 가장 흔한 실패 패턴을 미리 차단합니다.

프롬프트를 한 줄 캡션이 아니라 짧은 크리에이티브 브리프로 다루세요. 출력 품질의 진짜 차이가 바로 여기서 납니다.

/v1/tasks API로 재현하기

seedance-2.0@ext는 hiapi의 비동기 작업 엔드포인트를 통해 실행됩니다. 작업을 제출하고 완료될 때까지 폴링한 뒤 응답에서 비디오를 꺼내면 됩니다.

제출:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt와 aspect_ratio는 필수입니다. aspect_ratio를 생략하면 호출이 생성 단계에 도달하기 전에 검증에서 실패합니다. resolution, duration(4~15초), generate_audio는 선택 사항이며, 위 값은 이 글의 단편을 생성할 때 쓴 구성에 가깝습니다.

이미지 투 비디오 관점에서 왔다면 한 가지 짚고 넘어갈 점이 있습니다. 가격 페이지에는 이 모델의 이미지 투 비디오 요금이 적혀 있지만, 실제 입력 스키마는 텍스트 프롬프트만 받습니다. 이미지나 참조 프레임 필드는 거부됩니다. 가격 라벨이 어떻게 적혀 있든 실제로는 텍스트 투 비디오 모델입니다.

결과 폴링:

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

status가 성공을 보고하면 output[0].url이 완성된 .mp4를 가리킵니다. 이 링크는 임시이며 작업 응답의 만료 기간에 따라 약 일주일간 유효합니다. 따라서 링크를 그대로 걸지 말고 바이트를 즉시 내려받아 직접 저장하세요.

가격: 4K의 이상한 점

seedance-2.0@ext는 출력 초 단위로 과금되며, 요율은 해상도 등급에 따라 달라집니다.

해상도 초당 가격
720p $0.149
1080p $0.373
2K $0.662
4K $0.467

이 모델에서 4K가 2K보다 더 저렴하다는 점에 주목하세요. 초당 $0.467 대 $0.662입니다. 오타도 아니고 흔한 패턴도 아닙니다. 여기 대부분의 모델은 해상도가 올라갈수록 가격이 단조 증가합니다. 다른 모델도 그렇다고 가정하지 말고, 해상도 기반 비용 로직을 파이프라인에 넣기 전에 /api/pricing을 다시 확인하세요. 이런 등급은 실제로 조정되기 때문입니다.

참고로 위의 8초 720p 데모 단편 생성에는 $1.19가 들었습니다. 720p 등급에서 단순한 길이 × 초당 요율 계산입니다.

단편이 실제로 게시될 위치에 맞춰 해상도 선택하기

720p에서 1080p로 넘어가는 것만으로도 비용이 약 2.5배 늘어납니다. 따라서 대량으로 무언가를 생성하기 전에 해상도는 먼저 고려할 가치가 있는 레버입니다.

  • 피드 및 스토리 게시(TikTok, Reels, Shorts)는 거의 항상 휴대폰으로 시청되며 픽셀 밀도가 1080p 실제 밀도의 극히 일부에 불과합니다. 720p로도 구분되지 않으며 가장 저렴한 등급입니다.
  • 1080p는 단편이 랜딩 페이지 히어로에 재활용되거나 휴대폰 화면보다 큰 크기로 렌더링될 수 있는 유료 게재에 쓰일 때 가치가 있습니다.
  • 2K와 4K는 나중에 크롭, 줌, 안정화를 할 원본 소재에 적합합니다. 추가 해상도가 눈에 띄는 화질 손실 없이 재구도할 여유를 줍니다. 위 가격표를 보면 이 특정 모델에서는 4K가 둘 중 더 경제적인 선택입니다.

자주 묻는 질문

seedance-2.0@ext가 텍스트 투 비디오뿐 아니라 이미지 투 비디오도 지원하나요? 아니요. 가격 페이지에 이 모델의 이미지 투 비디오 요금이 적혀 있지만, ext 라우트의 실제 /v1/tasks 스키마는 텍스트 프롬프트만 받습니다. 이미지 URL, 참조 프레임, 참조 비디오 필드는 모두 거부됩니다. 플랫폼 모델 목록에 다른 설명이 나오기 전까지는 텍스트 투 비디오 전용으로 취급하세요.

생성되는 단편의 길이를 조정할 수 있나요? 네, 선택 사항인 duration 필드로 4~15초 사이의 정수를 지정할 수 있습니다. 생략하면 모델이 기본값을 적용합니다. 다운스트림 템플릿이 특정 길이를 기대한다면 명시적으로 설정하는 편이 안전합니다.

비디오에 오디오가 자동으로 포함되나요? 네이티브 오디오 생성은 선택 사항인 generate_audio 필드로 제공됩니다. 원하는 오디오를 프롬프트에 직접 적으면, 위의 "부드러운 따르는 물소리, 유리에 부딪히는 얼음 소리, 은은한 카페 환경 소음"처럼 화면 동작과 동기화되며 별도 오디오 파이프라인이 필요 없습니다.

4K가 정말 2K보다 저렴한가요, 아니면 표시 버그인가요? 이 글을 쓰는 시점(2026년 8월)의 현재 실제 가격이며 버그가 아닙니다. 다만 해상도 가격은 바뀔 수 있으므로 비용 모델에서 이에 의존하기 전에 /api/pricing과 대조해 확인하세요.

반환된 비디오 URL은 얼마나 유효한가요? 완료된 작업의 output[0].url은 임시 링크로, 작업의 만료 메타데이터에 따라 약 일주일간 유효합니다. 장기적으로 링크를 거는 대신 파일을 직접 내려받아 저장하세요.

다음에 할 일

이 모델의 전체 파라미터 세부 사항과 현재 가격은 seedance-2.0@ext 모델 페이지와 hiapi 가격 페이지에서 확인하세요. 같은 모델을 둘러싼 더 많은 프롬프트 패턴을 알고 싶다면 Seedance 2.0@ext 프롬프트 레시피에 더 많은 예시가 있고, Seedance 2.0 기반 숏폼 제품 쇼케이스는 같은 비동기 작업 워크플로를 다른 크리에이티브 브리프에 적용하는 방법을 설명합니다.

영구 AI 아티팩트로 빌드 시작하기

API 키를 받아 태스크 기반의 하나의 API로 이미지, 비디오, 오디오 모델을 호출하세요.

API 문서 보기