메인 콘텐츠로 건너뛰기
Krea는 ByteDance의 Seedance 영상 생성 모델에 대한 API 접근을 제공합니다. Krea의 Seedance API를 사용하면 텍스트로 영상을 생성하고, 이미지에 움직임을 더하고, 이미지·영상·오디오 레퍼런스로 생성을 가이드할 수 있습니다. 요청에는 Krea API 토큰과 https://api.krea.ai 기본 URL을 사용합니다.

사용 가능한 Seedance API 모델

이 모델들은 텍스트 투 비디오, 시작 및 끝 프레임, 레퍼런스 미디어, 네이티브 오디오를 지원합니다. 각 모델의 최신 요청 스키마는 API 레퍼런스를 참조하세요. 작업을 제출하기 전에 API 요금 ↗을 확인하세요. 가격은 모델과 생성 설정에 따라 달라집니다.
Krea의 Seedance 2.0 및 2.0 Fast 엔드포인트에는 기본 모델 외에 선택 사항인 Krea 프롬프트 개선과 업스케일링이 포함됩니다. Seedance 2.5에는 선택 사항인 Krea 프롬프트 개선이 포함됩니다. reference_videos를 사용하는 Seedance 2.5 영상 편집 요청에서는 출력 길이와 화면 비율이 원본 영상을 따르며, 이러한 요청에서는 duration과 aspect_ratio가 무시됩니다.

Seedance API 키 발급하기

API 키 및 청구 안내에 따라 Krea API 토큰을 만들고 API 잔액을 추가하세요. 토큰은 서버의 KREA_API_KEY 환경 변수에 저장하고, Authorization: Bearer $KREA_API_KEY 형식으로 전송하세요. 브라우저 코드에는 절대로 토큰을 노출하지 마세요. Krea 앱 컴퓨트와 API 잔액은 별개입니다. Krea API를 통한 Seedance 요청에는 워크스페이스의 API 잔액이 사용됩니다.

영상 생성하기

텍스트 투 비디오 생성을 위해 Seedance 2.5 엔드포인트에 프롬프트를 제출하세요. 아래 예시는 5초 길이의 720p 가로형 영상을 요청합니다.
JavaScript SDK는 npm install @krea-ai/sdk로 설치하세요. REST 요청은 완성된 영상이 아니라 job_id를 반환합니다. status가 completed가 될 때까지 2–5초마다 GET /jobs/{job_id}를 폴링한 다음, result.urls[0]에서 영상 URL을 확인하세요. 상태가 failed 또는 cancelled이면 폴링을 중단하세요. SDK의 jobs.wait 메서드는 폴링을 대신 처리해 줍니다.
cURL
프로덕션 연동에서는 웹훅을 사용해 완료 이벤트를 수신하세요. 작업 상태와 실패 처리에 대해서는 작업 생명주기와 오류 및 디버깅을 참조하세요.

이미지에 움직임 더하기

Seedance 이미지 투 비디오 생성에는 같은 엔드포인트를 사용하고 요청에 start_image를 추가하세요. 공개적으로 접근 가능한 이미지 URL, 업로드한 에셋 URL 또는 base64 데이터 URI를 전달할 수 있습니다.
start_image를 자신의 이미지 URL로 바꾸세요. 마지막 프레임을 제어하려면 end_image를 추가하세요. 레퍼런스 기반 생성에는 선택한 모델의 API 스키마에 따라 reference_images, reference_videos, reference_audios를 사용하세요.

자주 묻는 질문

Krea에서 ByteDance Seedance API를 제공하나요?

네. Krea는 https://api.krea.ai의 REST API를 통해 ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini를 제공합니다. Krea API 토큰으로 인증한 후 위에 나열된 Seedance 엔드포인트에 요청을 제출하세요.

Seedance를 텍스트 투 비디오와 이미지 투 비디오 모두에 사용할 수 있나요?

네. 텍스트 투 비디오에는 prompt를 보내고, 이미지에 움직임을 더하려면 start_image를 추가하세요. 두 워크플로 모두 같은 Seedance 모델 엔드포인트를 사용하며 비동기 작업을 반환합니다.

별도의 ByteDance API 키가 필요한가요?

아니요. Krea를 통한 Seedance 호출에는 Krea API 토큰과 워크스페이스 API 잔액이 사용됩니다. 이러한 요청에 별도의 ByteDance 자격 증명을 보낼 필요가 없습니다.

Krea에서 Seedance API 비용은 얼마인가요?

최신 Seedance 가격과 사용 가능한 설정은 Krea API 요금 ↗을 참조하세요. API 사용량은 Krea 앱 컴퓨트와 별도로 청구됩니다. 실패하거나 취소된 작업은 청구되지 않습니다.

AI 에이전트에서 Seedance를 호출할 수 있나요?

네. 에이전트를 Krea MCP 서버에 연결하면 사용 가능한 영상 모델과 스키마를 확인할 수 있습니다. 애플리케이션에서 REST API나 JavaScript SDK를 직접 호출할 수도 있습니다.