> ## 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.

# ByteDance Seedance API в Krea

> Используйте ByteDance Seedance 2.5 и 2.0 через Krea API. Генерируйте видео из текста или изображений с примерами на REST и JavaScript, API-ключами и ссылками на цены.

Krea предоставляет доступ через API к моделям генерации видео Seedance от ByteDance. С помощью Seedance API в Krea можно генерировать видео из текста, оживлять изображения или управлять генерацией с помощью референсных изображений, видео и аудио. Запросы используют API-токен Krea и базовый URL `https://api.krea.ai`.

## Доступные модели 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 |

Эти модели поддерживают text-to-video, начальный и конечный кадры, референсные медиафайлы и нативное аудио. Актуальную схему запроса для каждой модели см. в [справочнике API](https://www.krea.ai/docs/api-reference/introduction.md). Перед отправкой задачи проверьте [цены API ↗](https://www.krea.ai/app/api/pricing): стоимость зависит от модели и параметров генерации.

> [!NOTE]
>
> Эндпоинты Seedance 2.0 и 2.0 Fast в Krea включают опциональное улучшение промпта и апскейлинг от Krea сверх возможностей базовой модели. Seedance 2.5 включает опциональное улучшение промпта от Krea. Для запросов Seedance 2.5 на редактирование видео с `reference_videos` длительность и соотношение сторон результата берутся из исходного видео; `duration` и `aspect_ratio` в таких запросах игнорируются.

## Получение API-ключа Seedance

Создайте API-токен Krea и пополните API-баланс, следуя разделу [API-ключи и биллинг](https://www.krea.ai/docs/ru/developers/api-keys-and-billing.md). Храните токен в переменной окружения `KREA_API_KEY` на своём сервере. Передавайте его в заголовке `Authorization: Bearer $KREA_API_KEY` и никогда не раскрывайте его в браузерном коде.

Вычислительные ресурсы приложения Krea и API-баланс учитываются раздельно. Запросы к Seedance через Krea API списываются с API-баланса вашего рабочего пространства.

## Генерация видео

Отправьте промпт на эндпоинт Seedance 2.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`, а не готовое видео. Опрашивайте `GET /jobs/{job_id}` каждые 2–5 секунд, пока `status` не станет `completed`, затем получите URL видео из `result.urls[0]`. Прекратите опрос при статусе `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/ru/developers/webhooks.md), чтобы получать события о завершении. Состояния задач и обработку сбоев см. в разделах [Жизненный цикл задачи](https://www.krea.ai/docs/ru/developers/job-lifecycle.md) и [Ошибки и отладка](https://www.krea.ai/docs/ru/developers/errors-and-debugging.md).

## Анимация изображения

Для генерации видео из изображения с Seedance используйте тот же эндпоинт и добавьте в запрос `start_image`. Передайте общедоступный URL изображения, URL загруженного ассета или base64 data 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`. Для генерации по референсам используйте `reference_images`, `reference_videos` и `reference_audios` в соответствии со [схемой API](https://www.krea.ai/docs/api-reference/introduction.md) выбранной модели.

## Часто задаваемые вопросы

### Предлагает ли Krea ByteDance Seedance API?

Да. Krea предлагает ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast и Seedance 2.0 Mini через свой REST API по адресу `https://api.krea.ai`. Пройдите аутентификацию с API-токеном Krea и отправьте запрос на один из перечисленных выше эндпоинтов Seedance.

### Можно ли использовать Seedance и для text-to-video, и для image-to-video?

Да. Передайте `prompt` для генерации видео из текста или добавьте `start_image`, чтобы оживить изображение. Оба сценария используют один и тот же эндпоинт модели Seedance и возвращают асинхронную задачу.

### Нужен ли отдельный API-ключ ByteDance?

Нет. Вызовы Seedance через Krea используют ваш API-токен Krea и API-баланс рабочего пространства. Отправлять отдельные учётные данные ByteDance с этими запросами не нужно.

### Сколько стоит Seedance API в Krea?

Актуальные цены на Seedance и доступные параметры см. на странице [цен Krea API ↗](https://www.krea.ai/app/api/pricing). Использование API оплачивается отдельно от вычислительных ресурсов приложения Krea. Неудавшиеся и отменённые задачи не оплачиваются.

### Можно ли вызывать Seedance из ИИ-агента?

Да. Подключите агента к [MCP-серверу Krea](https://www.krea.ai/docs/ru/developers/mcp.md), чтобы находить доступные видеомодели и их схемы. Также можно вызывать REST API или JavaScript SDK напрямую из своего приложения.


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