BytePlus 공식 파트너ByteDance 계열사 BytePlus
개발자 API · BytePlus 공식 파트너
Seedance 2.0 API와 Seedream API
내 코드에서 Seedance 2.0으로 영상을, Seedream으로 이미지를 생성하세요. KreatorFlow는 ByteDance 계열사인 BytePlus 기반으로 운영됩니다. API 키 하나, 1토큰 $0.05의 선불 토큰, 업로드, 서명된 웹훅, 멱등성 요청을 지원합니다.
- /v1 REST 엔드포인트
- 1토큰 = $0.05
- 웹훅
- Idempotency-Key
- Seedance 2.0 최대 4K
최종 업데이트:
이 페이지의 내용
설정 없이 쓰는 Seedance, Seedream API
Seedance API, Seedream API, BytePlus API를 찾는 개발자가 원하는 것은 대개 같습니다. 프롬프트와 참고 자료 몇 개를 보내고, 완성된 영상이나 이미지를 받고, 쓴 만큼만 내는 것. KreatorFlow 개발자 API가 바로 그렇게 작동합니다. Seedance 2.0과 Seedream은 ByteDance의 모델이며, ByteDance 계열사인 BytePlus를 통해 제공됩니다, /v1 아래의 작은 REST 엔드포인트 묶음으로 호출합니다.
영상 모델은 안정적인 별칭(kreator-video-fast, kreator-video-seedance-2-fast, kreator-video-mini, kreator-video-seedance-2-mini, kreator-video-pro, kreator-video-seedance-2, kreator-video-seedance-2-5, kreator-video-wan-3, kreator-video-wan-3-prime, kreator-video-kling-3, kreator-video-kling-3-omni, kreator-video-kling-3-turbo, kreator-video-kling-4)으로, 이미지 모델은 kreator-image-fast, kreator-image-pro, kreator-image-wan-2-7-pro, kreator-image-wan-2-6, kreator-image-seedream-5-pro, kreator-image-seedream-5-flash로 제공됩니다. GET /v1/models가 별칭마다 길이, 비율, 해상도, 참고 자료 한도를 알려 주므로 한도를 코드에 박아 두지 않고 읽어 오면 됩니다. Seedance 2.0은 720p, 1080p, 4K로 4초에서 15초 클립을 만들고, 작업 하나에 이미지 9개, 클립 3개, 오디오 3개까지 참고 자료로 쓸 수 있습니다. Seedance 2.5는 720p, 1080p, 4K로 최대 30초 클립을 만듭니다.
엔드포인트
POST /v1/videos
Seedance 영상 작업: 텍스트로 영상, 이미지로 영상, 첫 프레임과 마지막 프레임, 참고 자료가 있는 영상.
POST /v1/video-edits
내 클립이나 사용 권리가 있는 클립을 편집, 스타일 변경, 변환, 연장합니다.
POST /v1/images
프롬프트, 참고 이미지, 캐릭터로 Seedream 이미지를 생성하고 편집합니다.
POST /v1/uploads
업로드를 만들고 PUT으로 파일을 보낸 뒤 업로드 ID를 참고 자료로 넘깁니다. 공개 호스팅이 필요 없습니다.
POST /v1/characters
반복해서 쓸 캐릭터를 한 번 등록하고, 이후 이미지와 영상 작업의 character_ids에 ID를 넘깁니다.
GET /v1/jobs/{job_id}
상태를 조회하고 결과를 가져옵니다. 같은 내용을 웹훅으로 받을 수도 있습니다.
curl로 바로 시작하기
Seedance 2.0 작업을 만들고, 상태를 조회하거나 웹훅을 기다리세요.
curl https://kreatorflow.ai/v1/videos \
-H "Authorization: Bearer $KREATORFLOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: launch-teaser-001" \
-d '{
"model": "kreator-video-seedance-2",
"prompt": "slow dolly in on a glass perfume bottle, soft studio light",
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p",
"webhook_url": "https://example.com/hooks/kreatorflow"
}'
curl https://kreatorflow.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $KREATORFLOW_API_KEY"API 콘솔에서 키를 만들고 KREATORFLOW_API_KEY로 내보낸 뒤 서버에만 보관하세요. Node와 Python 예제가 있는 전체 레퍼런스는 개발자 문서 (영문)에 있습니다.
토큰 가격
1토큰은 $0.05입니다. 가격은 작업이 접수되기 전에 계산되어 선불 잔액에서 차감됩니다.
Seedream 5.0 Lite 이미지
1
토큰 · $0.05 · kreator-image-fast
Seedream 4.5 이미지
2
토큰 · $0.10 · kreator-image-pro
Seedance 2.0 Mini, 720p 5초
7
토큰 · $0.35 · kreator-video-mini
Seedream 5.0 Flash 이미지
1
토큰 · $0.05 · kreator-image-seedream-5-flash
Seedream 5.0 Pro 이미지
2
토큰 · $0.10 · kreator-image-seedream-5-pro
Seedance 2 Fast, 720p 5초
9
토큰 · $0.45 · kreator-video-fast
Seedance 2.0, 720p 5초
11
토큰 · $0.55 · kreator-video-pro
Seedance 2.0, 1080p 5초
24
토큰 · $1.20 · kreator-video-pro
Seedance 2.0, 4K 5초
58
토큰 · $2.90 · kreator-video-pro
Seedance 2.5, 720p 5초
21
토큰 · $1.05 · kreator-video-seedance-2-5
Seedance 2.5, 1080p 30초
267
토큰 · $13.35 · kreator-video-seedance-2-5
콘솔에서 카드로 한 번에 $20부터 $5,000까지 충전합니다. API 토큰은 미국 달러로 결제됩니다. 월 요금도 구독도 없고, 실패한 작업에 예약됐던 토큰은 잔액으로 돌아옵니다. 다른 Seedance API와의 클립당 가격은 Seedance API 가격 비교에서 볼 수 있습니다.
KreatorFlow API가 대신 처리하는 것
- Seedance 2.5, Seedance 2.0, Seedance 2 Fast, Seedance 2.0 Mini, Seedream을 권한을 나눌 수 있는 KreatorFlow 키 하나로.
- 구독 없는 선불 토큰과 카드 충전.
- 내 워크스페이스로 범위가 제한된 업로드 ID, 그래서 참고 자료에 공개 URL이 필요 없습니다.
- 참고 이미지는 전송 전에 신뢰할 수 있는 에셋 라이브러리에 미리 준비됩니다.
- job.completed, job.failed, job.canceled, job.blocked 서명 웹훅.
- Idempotency-Key 지원: 같은 요청을 다시 보내면 중복 대신 원래 작업이 돌아옵니다.
- 멈춘 이미지 전송의 자동 재시도와, 작업 실패 시 예약 토큰 해제.
- 반복해서 쓰는 캐릭터와 원본 영상 편집을 간단한 엔드포인트로.
세 단계로 시작하기
- 1
계정과 키 만들기
developers.kreatorflow.ai의 API 콘솔에 로그인하고 API 키를 만드세요.
- 2
토큰 충전하기
Billing 탭에서 $20 이상을 충전하세요. 잔액은 계정의 모든 키가 함께 씁니다.
- 3
첫 작업 보내기
Idempotency-Key와 함께 POST /v1/videos나 POST /v1/images를 호출하고, 상태를 조회하거나 웹훅을 받으세요.
사용 규칙
API도 스튜디오와 같은 허용 사용 정책 (영문)을 따릅니다. 참고 자료는 직접 만들었거나 사용 권리가 있는 것이어야 합니다. 코드 대신 직접 만들고 싶다면 같은 모델을 Seedance 2.0 영상 생성기에서 쓸 수 있습니다.
Seedance API 자주 묻는 질문
공식 Seedance API인가요?
ByteDance 계열사인 BytePlus를 기반으로 KreatorFlow가 만든 자체 API입니다. KreatorFlow는 ByteDance 계열사인 BytePlus의 공식 파트너이며, 요청은 BytePlus를 거쳐 Seedance 2.0과 Seedream으로 전달되고, KreatorFlow의 안정적인 모델 별칭과 KreatorFlow 키 하나로 쓸 수 있습니다.
Seedance 2.0 API는 얼마인가요?
선불 토큰으로 결제하며 1토큰은 $0.05입니다. Seedance 2.0 720p 5초 클립은 11토큰, 같은 길이의 Seedance 2 Fast는 9토큰, Seedance 2.0 Mini는 7토큰, Seedream 4.5 이미지는 2토큰입니다. 충전은 $20부터 $5,000까지 가능합니다.
Seedream API에 참고 이미지를 쓸 수 있나요?
네. POST /v1/uploads로 이미지를 올리고 받은 업로드 ID를 참고 이미지로 넘기거나, 공개 HTTPS URL을 보내면 됩니다. kreator-image-pro(Seedream 4.5)는 참고 이미지를 최대 14장까지 받고, 반복해서 쓸 캐릭터는 POST /v1/characters로 한 번 등록하면 됩니다.
웹훅을 받나요, 아니면 상태를 계속 조회해야 하나요?
둘 다 됩니다. 생성 요청에 webhook_url을 넣으면 job.completed, job.failed, job.canceled, job.blocked 이벤트를 받고, 각 이벤트는 Webhooks 탭의 시크릿으로 만든 X-KreatorFlow-Signature로 서명됩니다. 또는 GET /v1/jobs/{job_id}로 조회하세요.
작업이 실패하면 어떻게 되나요?
토큰은 작업이 시작될 때 예약되고, 작업이 실패하거나 시간 초과되거나 전송 전에 거부되면 풀립니다. 실패한 작업에는 비용을 내지 않습니다. 같은 Idempotency-Key로 요청을 다시 보내면 중복 작업 대신 원래 작업이 돌아오므로 네트워크 재시도가 안전합니다. 새로 시도할 때는 새 키를 쓰세요.