> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Krea의 ByteDance Seedance API

> Krea API로 ByteDance Seedance 2.5 및 2.0을 사용하세요. REST와 JavaScript 예시, API 키, 요금 안내 링크와 함께 텍스트나 이미지로 영상을 생성합니다.

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

## 사용 가능한 Seedance API 모델

| 모델 | POST 엔드포인트 | 영상 길이 | 출력 해상도 |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4–30초 | 480p, 720p, 1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4–15초 | 480p, 720p, 1080p, 4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4–15초 | 480p, 720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4–15초 | 480p, 720p |

이 모델들은 텍스트 투 비디오, 시작 및 끝 프레임, 레퍼런스 미디어, 네이티브 오디오를 지원합니다. 각 모델의 최신 요청 스키마는 [API 레퍼런스](https://www.krea.ai/docs/api-reference/introduction.md)를 참조하세요. 작업을 제출하기 전에 [API 요금 ↗](https://www.krea.ai/app/api/pricing)을 확인하세요. 가격은 모델과 생성 설정에 따라 달라집니다.

> [!NOTE]
>
> Krea의 Seedance 2.0 및 2.0 Fast 엔드포인트에는 기본 모델 외에 선택 사항인 Krea 프롬프트 개선과 업스케일링이 포함됩니다. Seedance 2.5에는 선택 사항인 Krea 프롬프트 개선이 포함됩니다. `reference_videos`를 사용하는 Seedance 2.5 영상 편집 요청에서는 출력 길이와 화면 비율이 원본 영상을 따르며, 이러한 요청에서는 `duration`과 `aspect_ratio`가 무시됩니다.

## Seedance API 키 발급하기

[API 키 및 청구](https://www.krea.ai/docs/ko/developers/api-keys-and-billing.md) 안내에 따라 Krea API 토큰을 만들고 API 잔액을 추가하세요. 토큰은 서버의 `KREA_API_KEY` 환경 변수에 저장하고, `Authorization: Bearer $KREA_API_KEY` 형식으로 전송하세요. 브라우저 코드에는 절대로 토큰을 노출하지 마세요.

Krea 앱 컴퓨트와 API 잔액은 별개입니다. Krea API를 통한 Seedance 요청에는 워크스페이스의 API 잔액이 사용됩니다.

## 영상 생성하기

텍스트 투 비디오 생성을 위해 Seedance 2.5 엔드포인트에 프롬프트를 제출하세요. 아래 예시는 5초 길이의 720p 가로형 영상을 요청합니다.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body https://api.krea.ai/generate/video/bytedance/seedance-2-5 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow camera orbit around a ceramic vase in warm studio light",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

```javascript JavaScript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("bytedance/seedance-2-5", {
  prompt: "A slow camera orbit around a ceramic vase in warm studio light",
  duration: 5,
  aspect_ratio: "16:9",
  resolution: "720p"
});

const completed = await krea.jobs.wait(job.job_id);
console.log(completed.result.urls[0]);
```

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` 메서드는 폴링을 대신 처리해 줍니다.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body "https://api.krea.ai/jobs/YOUR_JOB_ID" \
  -H "Authorization: Bearer $KREA_API_KEY"
```

프로덕션 연동에서는 [웹훅](https://www.krea.ai/docs/ko/developers/webhooks.md)을 사용해 완료 이벤트를 수신하세요. 작업 상태와 실패 처리에 대해서는 [작업 생명주기](https://www.krea.ai/docs/ko/developers/job-lifecycle.md)와 [오류 및 디버깅](https://www.krea.ai/docs/ko/developers/errors-and-debugging.md)을 참조하세요.

## 이미지에 움직임 더하기

Seedance 이미지 투 비디오 생성에는 같은 엔드포인트를 사용하고 요청에 `start_image`를 추가하세요. 공개적으로 접근 가능한 이미지 URL, 업로드한 에셋 URL 또는 base64 데이터 URI를 전달할 수 있습니다.

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "prompt": "The camera slowly moves closer as soft light shifts across the scene",
  "start_image": "https://your-domain.example/product.png",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

`start_image`를 자신의 이미지 URL로 바꾸세요. 마지막 프레임을 제어하려면 `end_image`를 추가하세요. 레퍼런스 기반 생성에는 선택한 모델의 [API 스키마](https://www.krea.ai/docs/api-reference/introduction.md)에 따라 `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 요금 ↗](https://www.krea.ai/app/api/pricing)을 참조하세요. API 사용량은 Krea 앱 컴퓨트와 별도로 청구됩니다. 실패하거나 취소된 작업은 청구되지 않습니다.

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

네. 에이전트를 [Krea MCP 서버](https://www.krea.ai/docs/ko/developers/mcp.md)에 연결하면 사용 가능한 영상 모델과 스키마를 확인할 수 있습니다. 애플리케이션에서 REST API나 JavaScript SDK를 직접 호출할 수도 있습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.