Felo OpenAPI에서 Seedance: 네 가지 비디오 모델, 하나의 엔드포인트
Felo OpenAPI가 이제 비디오 생성을 지원합니다. 네 가지 ByteDance Seedance 모델, 초 단위 과금, 기존에 사용하던 동일한 API 키.
앱에서 한 번의 API 호출로 대본 작성, 샷 리스트 작성, 리뷰 노트 요약까지 처리할 수 있습니다. 하지만 실제 비디오를 만들려면 스택을 벗어나야 했습니다. 다른 공급자, 다른 키, 다른 결제 대시보드, 그리고 별도의 비동기 패턴이 필요했습니다.
이제 그 간극이 사라졌습니다. Felo OpenAPI가 비디오 생성을 지원합니다. 네 가지 ByteDance Seedance 모델이 기존에 사용하던 LLM 라우트와 동일한 플랫폼, 동일한 기본 URL, 동일한 FELO_API_KEY로 동작합니다. 가장 저렴한 대량 작업용 라우트부터, 오디오가 포함된 30초 레퍼런스 가이드 클립을 생성하는 ByteDance의 최신 모델 Seedance 2.5까지 모두 사용할 수 있습니다.
Seedance 2.5를 Felo OpenAPI에서 체험해보세요: https://openapi.felo.ai/models/bytedance/seedance-2.5
네 가지 모델 한눈에 보기
Felo API Platform에는 27개의 모델이 있습니다. 이 중 네 가지가 비디오를 생성하며, 길이, 해상도, 속도, 비용 중 어떤 요소를 최적화할지에 따라 선택할 수 있습니다.
| Model | Best for | Resolution | Clip length | From |
|---|---|---|---|---|
| Seedance 2.5 | 장편 스토리텔링, 비디오 편집, 비디오 확장, 다국어 오디오 | 480p / 720p | 4–30초 | $0.1028/초 |
| Seedance 2.0 | 플래그십 품질: 캐릭터 일관성, 스타일 전환, 4K 출력 | 480p – 4K | 4–15초 | $0.06725/초 |
| Seedance 2.0 Fast | 빠른 반복 및 초안 렌더링 | 480p / 720p | 4–15초 | $0.04035/초 |
| Seedance 2.0 Mini | 대량 생성 및 소셜 클립 | 480p / 720p | 4–15초 | $0.03363/초 |
각 모델의 특징은 다음과 같습니다.
Seedance 2.5 — 장편용 라우트
Seedance 2.5는 ByteDance의 최신 Seedance 모델입니다. 최대 30초 클립을 한 번에 렌더링하며, 한 요청에 최대 50개의 이미지, 비디오, 오디오 레퍼런스 에셋을 받을 수 있습니다. 반복 등장하는 캐릭터, 제품, 세트 요소마다 각각의 레퍼런스를 지정해 긴 테이크에서도 일관성을 유지할 수 있습니다.
생성 기능을 넘어, 비디오 편집(전체 클립을 다시 생성하지 않고 특정 영역만 수정)과 비디오 확장(마지막 프레임 이후로 클립을 이어가거나 두 샷을 연결)도 지원합니다. 오디오는 영상과 함께 생성되며, 다국어 지원이 포함되어 여러 시장에서 하나의 캠페인 영상을 사용할 때 유용합니다.
이럴 때 사용: 스토리가 몇 초 이상 필요할 때, 여러 레퍼런스로 전체 캐스트를 고정해야 할 때, 클립을 다시 촬영하지 않고 수정해야 할 때.
Seedance 2.0 — 4K 플래그십
Seedance 2.0은 ByteDance의 플래그십 라우트이며, 여기서 유일하게 최대 4K까지 렌더링합니다. 레퍼런스 자료의 캐릭터 일관성, 시각적 스타일, 카메라 무브먼트 보존에 강점을 보입니다. 얼굴, 제품, 프레이밍이 입력한 이미지에서 그대로 이어집니다.
이럴 때 사용: 대형 스크린이나 과감한 크롭에도 견뎌야 하는 결과물, 제품 영상, 브랜드 광고 등 최종 납품 해상도가 중요한 경우.
Seedance 2.0 Fast — 반복용 라우트
Seedance 2.0 Fast는 품질 대신 속도와 비용을 우선합니다. 최대 720p까지 렌더링하며, 방향을 탐색하는 단계에 적합합니다.
이럴 때 사용: 같은 샷을 다섯 번 시도해보고 하나를 선택할 때, 러프 컷만으로 리뷰가 충분할 때.
Seedance 2.0 Mini — 대량용 라우트
Seedance 2.0 Mini는 플랫폼에서 가장 저렴한 Seedance 라우트로, 대량 생성에 적합합니다. 소셜 클립, 쇼핑 변형, A/B 크리에이티브 등 단위당 비용이 예산을 결정하는 작업에 적합합니다.
이럴 때 사용: 대량 생성이 목적이고 720p 해상도가 충분할 때.
비디오 API 작동 방식
플랫폼의 모든 모델은 하나의 엔드포인트와 동일한 패턴을 사용합니다. 작업을 제출하고, 상태를 폴링하고, 결과를 다운로드합니다.
POST https://openapi.felo.ai/api/v1/videos/generations
GET https://openapi.felo.ai/api/v1/videos/generations/$TASK_ID
비디오 생성은 채팅 완성보다 시간이 더 걸리므로, API는 기본적으로 비동기 방식입니다. 프롬프트와 파라미터로 작업을 제출하고, 상태가 succeeded가 될 때까지 폴링한 후, 서명된 출력 URL을 다운로드합니다. 조합할 필요도, 웹훅을 미리 연결할 필요도 없습니다.
세 가지 생성 라우트가 제공됩니다.
- 텍스트 투 비디오 — 샷을 설명하고 렌더링합니다.
- 첫 프레임과 마지막 프레임 — 오프닝과 클로징 프레임을 제공해 편집에 맞게 정확히 클립을 만듭니다.
- 멀티모달 레퍼런스 — 이미지, 비디오, 오디오를 레퍼런스로 제공해 클립마다 캐릭터와 제품의 일관성을 유지합니다.
지원하는 화면비는 16:9, 9:16, 1:1, 4:3, 3:4, 그리고 21:9입니다. 2.0 라우트에서는 9:21도 선택할 수 있습니다. 오디오도 포함됩니다. generate_audio를 요청하면 추가 비용 없이 오디오 트랙이 포함된 비디오가 반환됩니다.
첫 비디오 요청하기
1단계: API 키 발급
플랫폼의 API 키 페이지에서 키를 생성하고 내보냅니다. 키는 한 번만 표시되므로, 백엔드에서 읽을 수 있는 안전한 곳에 저장하세요. 클라이언트 코드에는 저장하지 않습니다.
export FELO_API_KEY="YOUR_API_KEY"
2단계: 비디오 작업 제출
모델과 파라미터를 설정하고 요청을 보냅니다.
curl -X POST "https://openapi.felo.ai/api/v1/videos/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "a cinematic drone shot over a coastal city at sunrise",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9",
"generate_audio": true
}'
응답에는 작업 ID가 포함됩니다. seedance-2.5 대신 seedance-2.0, seedance-2.0-fast, seedance-2.0-mini로 바꾸면 동일한 요청을 다른 모델로 보낼 수 있습니다.
3단계: 작업 폴링
curl "https://openapi.felo.ai/api/v1/videos/generations/$TASK_ID" \
-H "Authorization: Bearer $FELO_API_KEY"
4단계: 결과 다운로드
상태가 succeeded가 되면 응답에 서명된 출력 URL이 포함됩니다. 이를 받아 MP4 파일로 저장합니다.
curl -o output.mp4 "$OUTPUT_URL"
코딩 대신 클릭을 선호한다면, 각 모델 페이지에 플레이그라운드가 있습니다. 실제 API 키로 요청을 보내고, 서명된 URL이 준비될 때까지 작업을 모니터링합니다. 프로덕션에 연결하기 전에 동일한 프롬프트로 네 가지 모델을 빠르게 비교할 수 있습니다.
비용 안내
비디오 라우트는 출력 1초당 과금됩니다. 계산이 간단합니다. 5초 클립은 해당 모델과 해상도의 초 단가에 5를 곱하면 됩니다.
| Model | 480p | 720p | 1080p | 4K |
|---|---|---|---|---|
| Seedance 2.5 | $0.1028 | $0.2311 | — | — |
| Seedance 2.0 | $0.06725 | $0.1512 | $0.3742 | $0.7776 |
| Seedance 2.0 Fast | $0.04035 | $0.09072 | — | — |
| Seedance 2.0 Mini | $0.03363 | $0.0756 | — | — |
모든 단가는 출력 1초 기준입니다. 두 가지 요소가 비용에 영향을 줍니다.
- 오디오는 무료입니다.
generate_audio를 켜도 단가는 변하지 않습니다. - 비디오 레퍼런스는 할인됩니다. 비디오를 레퍼런스로 전달하면 표준 단가보다 약 40% 낮은 단가가 적용됩니다. 예를 들어 Seedance 2.5의 720p는 초당 $0.2311에서 $0.1382로 내려갑니다.
예시로 몇 가지 기준점을 정리하면 다음과 같습니다.
| Clip | Cost |
|---|---|
| 5초, 720p, Seedance 2.0 Mini | $0.38 |
| 5초, 720p, Seedance 2.0 | $0.76 |
| 30초, 720p, Seedance 2.5 | $6.93 |
| 15초, 4K, Seedance 2.0 | $11.66 |
어떤 모델을 선택해야 할까?
| 필요에 따라 | 추천 모델 |
|---|---|
| 30초 내러티브 클립, 대사, 시장별 현지화 버전 | Seedance 2.5 |
| 여러 클립에서 동일한 캐릭터나 제품의 일관성 | Seedance 2.0 (또는 레퍼런스 포함 2.5) |
| 4K 최종 납품 | Seedance 2.0 — 유일하게 4K 지원 |
| 예산을 초과하지 않는 20가지 소셜 변형 | Seedance 2.0 Mini |
| 점심 전 다섯 가지 방향 탐색, 이후 하나 완성 | Seedance 2.0 Fast, 이후 2.0 또는 2.5 |
| 이미 생성한 클립의 확장 또는 편집 | Seedance 2.5 |
에이전트 스택에서의 위치
가장 큰 변화는 위치입니다. 이제 비디오도 파이프라인의 다른 작업과 같은 위치에서 처리됩니다. 이미 브리프를 작성하고, 샷을 선택하고, 카피를 초안하는 에이전트가 동일한 키와 Bearer 인증으로 비디오 모델에도 작업을 전달할 수 있습니다.
이렇게 하면 다중 벤더 파이프라인이 단일 파이프라인으로 바뀝니다. LLM이 장면 설명을 작성하고, Seedance가 렌더링하며, 결과물이 MP4로 저장소에 바로 들어갑니다. 모델 페이지에서 "에이전트와 함께 사용"을 주요 시나리오로 안내하는 이유가 여기에 있습니다.
FAQ
비디오용 별도 계정이나 키가 필요한가요?
아닙니다. 비디오 모델도 LLM 라우트와 동일한 Felo OpenAPI 플랫폼에서 동작합니다. 하나의 API 키로 모두 사용할 수 있고, 모든 요청에 동일한 Bearer 인증이 적용됩니다.
Seedance 2.5와 Seedance 2.0의 차이점은 무엇인가요?
Seedance 2.5는 최신 장편 라우트입니다. 최대 30초 클립, 최대 50개의 레퍼런스 에셋, 비디오 편집 및 확장, 다국어 오디오를 지원합니다. Seedance 2.0은 플래그십 품질 라우트이며, 유일하게 4K까지 렌더링합니다.
소리가 포함된 비디오도 생성할 수 있나요?
네. 요청에 generate_audio를 설정하면 오디오 트랙이 포함된 결과물이 반환됩니다. 오디오 생성은 과금 단가에 영향을 주지 않으며, Seedance 2.5는 다국어 오디오비주얼 생성도 지원합니다.
비디오 API는 동기 방식인가요?
아닙니다. 비디오 생성은 비동기 방식입니다. 작업을 제출하고, 작업 ID로 상태가 succeeded가 될 때까지 폴링한 후, 서명된 출력 URL을 다운로드합니다.
왜 초 단위 과금인가요?
출력 길이가 실제로 연산량을 결정하기 때문입니다. 초 단위 과금으로 4초 테스트와 30초 메인 클립의 비용이 비례하며, 렌더링 전에 캠페인 비용을 예측할 수 있습니다.
코딩 없이도 체험할 수 있나요?
네. 각 모델 페이지에는 실제 API 키로 생성 요청을 실행하고 작업 완료까지 추적하는 플레이그라운드가 있습니다. 먼저 직접 프롬프트로 모델을 비교해볼 수 있습니다.
두 번째 스택 없이 비디오 생성
텍스트, 코드, 이미지, 그리고 이제 비디오까지. 하나의 API 키, 하나의 기본 URL, 하나의 결제 라인에서 모두 사용할 수 있습니다. 네 가지 Seedance 모델이 $0.38 초안부터 4K 메인 클립까지 전 범위를 커버하며, 비동기 패턴도 모두 동일한 세 단계로 처리합니다.
모델 페이지를 열고, 키를 발급받아, 한 번 요청을 보내보세요. 첫 번째 클립이 어떤 스펙시트보다 더 많은 정보를 줍니다.
Seedance 모델을 Felo OpenAPI에서 살펴보기 →
이 글은 다음 언어로도 읽을 수 있습니다: English, 简体中文, 日本語, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা, Português.