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 가로형 영상을 요청합니다.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 모델 엔드포인트를 사용하며 비동기 작업을 반환합니다.