<!-- Canonical URL: https://ask.atlascloud.ai/ru/seedance-2-5-api-quickstart-first-video-atlas-cloud -->

# Seedance 2.5 API Quickstart: Generate Your First Video with Atlas Cloud

> Ship a working Seedance video integration today on Atlas Cloud with one API key and two REST calls, then swap in Seedance 2.5 at launch by changing one model string.

Вы прочитали анонс [Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud), набросали функцию продукта, основанную на 30-секундных сгенерированных клипах, и теперь хотите написать код. Затем вы сталкиваетесь с проблемой, с которой сталкивается каждый разработчик с только что анонсированной моделью: страница возможностей запущена, но конечная точка, которую вы действительно можете вызвать из своего приложения, — это совершенно другой вопрос.

Вот честная версия ситуации и краткое руководство, которое ее учитывает. Atlas Cloud опубликовал страницу семейства [Seedance](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 2.5, обязуясь предоставить доступ в День 0 на тех же унифицированных конечных точках, которые уже обслуживают [Seedance 2.0](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) и 1.5. На момент написания этого списка он помечен как «Скоро» и цена Atlas Cloud для Seedance 2.5 не опубликована. Что это означает на практике, так это хорошие новости: интеграция, которую вы создаете сегодня для действующего уровня Seedance, — это та же интеграция, которую вы будете использовать при запуске 2.5. Изменяется только строка модели.

Таким образом, это краткое руководство выполняет две задачи. Оно позволяет получить реальное видео из реальной конечной точки сегодня, и оно структурирует ваш код и ваши подсказки так, что обновление представляет собой однострочное изменение.

## Что на самом деле поставляется в Seedance 2.5

Согласно официальной странице Seedance 2.5 от ByteDance, это модель совместной генерации аудио-видео нового поколения, созданная для 30-секундного повествования с точным контролем ссылок и мощным редактированием. Конкретные утверждения, на основе которых стоит проектировать:

* До 30 секунд в одной генерации, с возможностью расширения в два раза для более длительного и полного повествования
* Более плавное и последовательное движение, с более реалистичными визуальными эффектами
* Более точное понимание эталонного видео, улавливающее намерение, кадрирование и кинематографический язык, а не просто передачу движения
* Более надежное редактирование в более широком диапазоне запросов на аудио- и визуальное редактирование
* Управление белой моделью и редактирование зеленого экрана, а также профессиональное движение камеры и блокировка производительности, направленные на сложные рабочие процессы производства

Обратите внимание, чего нет в этом списке: нет таблицы бенчмарков, нет лестницы разрешений, нет количества эталонных активов. Все, что вы видели в этом роде, — это маркетинговый глянец кого-то, а не спецификация от первого лица. Стройте на основе вышеуказанных утверждений.

## Шаг 1: получите ключ из консоли

Войдите на console.atlascloud.ai и создайте ключ API. Нет депозита, нет минимальных обязательств и нет списка ожидания, поэтому ключ можно использовать немедленно по принципу «плати по мере использования». Один ключ охватывает весь каталог из более чем 300 моделей для текста, изображений и видео, на одном платежном счете, что важно для этого краткого руководства: ключ, который вы создадите сейчас, — это тот же ключ, который будет вызывать Seedance 2.5.

Храните его как переменную окружения, никогда не в исходном коде. `ATLASCLOUD_API_KEY` — хорошее название.

## Шаг 2: отправьте задание на видео

Генерация видео на Atlas Cloud — это двухэтапный асинхронный вызов REST, а не завершение чата. Вы отправляете задание POST и получаете обратно идентификатор предсказания, затем вы опрашиваете этот идентификатор, пока рендеринг не завершится. Подойдет любой HTTP-клиент, поэтому нет необходимости устанавливать SDK поставщика и изучать новую схему аутентификации: это токен-носитель на ключе, который вы только что создали.

```python
import os, time, requests

KEY  = os.environ["ATLASCLOUD_API_KEY"]
BASE = "https://api.atlascloud.ai/api/v1/model"
HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}

job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
    "model": "bytedance/seedance-2.0/text-to-video",
    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
              "neon reflections on wet asphalt, slight lag on turns.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": True,
    "watermark": False,
}).json()

prediction_id = job["data"]["id"]
```

Ответ приходит в виде `{"code": 200, "data": {"id": "...", "status": "processing"}}`. Обратите внимание, что `model` — это просто строковое поле. Эта деталь — вся история обновления для этой статьи, и Шаг 6 возвращается к ней.

## Шаг 3: опрашивайте, пока рендеринг не завершится

5-секундный клип не является мгновенным ответом, поэтому рассматривайте рендеринг как задание с жизненным циклом, а не как блокирующий вызов. Опрашивайте конечную точку предсказания, пока `status` не достигнет конечного значения.

```python
while True:
    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
    status = r["data"]["status"]
    if status in ("completed", "succeeded", "failed"):
        break
    time.sleep(3)

print(status, r["data"])   # on success the payload carries the output URL(s)
```

Две вещи, которые стоит встроить сейчас, а не позже. Установите потолок для цикла опроса, чтобы застрявшее задание не могло зависнуть обработчик запросов, и сохраните идентификатор предсказания, прежде чем начать опрос, чтобы сбойный рабочий процесс мог возобновиться вместо того, чтобы платить за рендеринг дважды. Обе привычки переносятся без изменений на 2.5.

Если ваша функция работает с эталонным изображением или эталонным объектом вместо чистого текста, применяется тот же поток с другим вариантом модели: `bytedance/seedance-2.0/image-to-video` или `bytedance/seedance-2.0/reference-to-video`. Эталонные активы объекта загружаются один раз через `uploadMedia`, а затем передаются как `asset://<id>` в полях изображения, поэтому повторяющийся персонаж или продукт не требует повторной загрузки при каждом вызове.

## Шаг 4: выберите действующий уровень Seedance и узнайте, сколько стоит секунда

Atlas Cloud выставляет счета за видео по секундам выходной продолжительности. Это арифметика, которую вы можете выполнить в уме, прежде чем писать какой-либо код. Сегодня действуют три уровня Seedance:

| Модель | Идентификатор модели | Цена Atlas Cloud | Примечание |
|---|---|---|---|
| Seedance 2.0 | `bytedance/seedance-2.0/text-to-video` | $0.112/с | Флагманский действующий уровень, мгновенный ключ, без списка ожидания |
| [Seedance 2.0 Fast](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/text-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-fast/text-to-video` | $0.09/с | Более быстрый вариант того же семейства |
| [Seedance 2.0 Mini](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-mini/text-to-video` | $0.056/с | Самый дешевый действующий уровень Seedance 2.0, также image-to-video и reference-to-video |
| [Seedance 1.5 Pro](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-v1.5-pro/text-to-video` | $0.047/с, или $0.018/с для варианта Fast | Нативное синхронизированное аудио, многоязычная синхронизация губ, клипы от 4 до 12 секунд |

Для ориентировки, другие видеомодели на том же ключе работают в сопоставимом диапазоне: Grok Imagine Video v1.5 по $0.080/с, [Wan 2.7](https://www.atlascloud.ai/models/alibaba/wan-2.7?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) по $0.100/с, [Kling](https://www.atlascloud.ai/models/kling-v3?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) V3.0 Turbo по $0.112 стандарт и $0.095 со скидкой, MiniMax H3 по $0.14/с.

На каком из них строить, зависит от того, что в конечном итоге будет делать ваша функция 2.5. Если аудио является центральным элементом вывода, Seedance 1.5 Pro — это уровень, который уже имеет нативное синхронизированное аудио и многоязычную синхронизацию губ, поэтому ваш конвейер научится обрабатывать звуковую дорожку с первого дня. Если вы экспериментируете со структурой подсказок и хотите получить наименьшую стоимость за эксперимент, Seedance 2.0 Mini по $0.056/с — очевидная песочница. Если вы хотите получить нечто максимально близкое к рендерингу текущего поколения производственного уровня, Seedance 2.0 по $0.112/с — это простой выбор, с вариантом Fast по $0.09/с, если пропускная способность важнее последнего прироста качества.

## Шаг 5: проверьте текущую цену в Playground, прежде чем тратить

Перед первым платным вызовом откройте модель в Atlas Cloud Playground. Каждая модель показывает свою текущую цену за модель рядом с кнопкой «Запустить». Это важнее, чем кажется: рекламные скидки приходят и уходят, и число рядом с кнопкой «Запустить» — это то, что будет фактически выставлено. Запустите одну генерацию в Playground, убедитесь, что вывод соответствует потребностям вашей функции, затем перенесите настройки в код.

Модель «по секундам на выходе» также делает ваш разговор о бюджете тривиальным. 10-секундный клип на Seedance 2.0 Mini — это 10 × $0.056. Нет калькулятора, нет оценки токенов и нет этапа последующего согласования.

Это стоит сравнить с тем, как каналы ByteDance от первого лица выставляют счета за Seedance. На Volcano Engine Ark в Китае и BytePlus ModelArk на международном уровне выставление счетов основано на токенах: предполагаемое потребление токенов составляет (продолжительность входного видео + продолжительность выходного видео) × ширина вывода × высота вывода × частота кадров вывода / 1024, умноженное на цену единицы токена, при этом фактическое использование является авторитетным из поля `usage.completion_tokens` в ответе API. Для серии Seedance 2.0 и Seedance 2.5, когда вход включает видео, применяется минимальный порог потребления токенов, и порог зависит от разрешения, соотношения сторон и продолжительности вывода. ByteDance публикует калькулятор цен плюс таблицу минимальных токенов именно по этой причине.

Обе модели легитимны. Но если вы планируете 30-секундный рендеринг, продолжительность «по секундам на выходе» — это умственная арифметика, а токены с порогами требуют электронной таблицы.

## Шаг 6: напишите описание кадра, как будто это уже 2.5

Это та часть краткого руководства, которая идеально переносится, потому что создание подсказок не версионируется. Два из утверждений о возможностях 2.5 должны изменить то, как вы пишете сегодня.

**Точный контроль ссылок.** Утверждение ByteDance заключается в том, что 2.5 считывает эталонное видео на предмет его намерения, кадрирования и кинематографического языка, выходя за рамки передачи движения. Следствие для подсказок заключается в том, что ваш эталонный актив перестает быть шаблоном движения и становится режиссерским брифом. Поэтому перестаньте писать подсказки, описывающие только объект, и начните называть грамматику, которую вы хотите перенести: ощущение объектива, кадрирование, темп монтажа, ведет ли камера или следует за объектом. Пишите «ручная, средний план, следующий за объектом, курьер пробирается по ночному рынку, неоновые отражения на мокром асфальте, небольшая задержка на поворотах» вместо «человек идет, кинематографично».

**Тридцать секунд в одной генерации.** 5-секундный клип — это один кадр. Тридцать секунд — это сцена со структурой, и 2.5 поддерживает расширение в два раза сверх этого. Поэтому пишите описания кадров с ритмической структурой, а не с одним статическим описанием: установочный ритм, изменение (поворот, вход, раскрытие) и разрешение. Явно называйте движение камеры и блокировку производительности, поскольку это именно те элементы управления, на которые нацелен 2.5. Где стоит объект, куда он движется, что делает камера, пока он движется.

Обе привычки окупаются на действующих уровнях сейчас. Обе являются именно теми привычками, которые вознаграждает 2.5.

## Шаг 7: спланируйте замену

Структурируйте свой код так, чтобы идентификатор модели был конфигурацией, а не литералом. Одна константа, считываемая из окружения или конфигурации:

```python
SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
```

Затем передайте `SEEDANCE_MODEL` туда, где Шаг 2 жестко закодировал строку. Поскольку `model` — это одно строковое поле JSON в теле `generateVideo`, обновление при запуске 2.5 действительно является одной переменной окружения. Не метафора для небольшого изменения, буквально одно значение.

Никогда не жестко кодируйте идентификатор Seedance 2.5 сегодня, потому что идентификатор модели Atlas Cloud Seedance 2.5 еще не существует. Получайте точные действующие идентификаторы из каталога на atlascloud.ai/models, а не копируйте их из статьи, включая эту, поскольку со временем добавляются новые варианты. Когда 2.5 появится в рамках обязательства «День 0», работа с вашей стороны будет заключаться в этой одной переменной, а также в свежем взгляде на цену рядом с кнопкой «Запустить» и повторном прочтении любых новых параметров запроса, поскольку 30-секундная модель с поддержкой расширения, вероятно, будет принимать поля, которых нет в теле 2.0.

Между тем, если вам нужен Seedance 2.5 сегодня, а не при запуске Atlas Cloud, честный ответ — это каналы ByteDance от первого лица: Volcano Engine Ark в Китае и BytePlus ModelArk на международном уровне. Среди агрегаторов несколько находятся в том же состоянии предзапуска или обязательства «День 0».

## FAQ

В: Могу ли я вызвать Seedance 2.5 на Atlas Cloud прямо сейчас?
О: Нет. Страница семейства Seedance 2.5 на Atlas Cloud помечена как «Скоро» с обязательством доступа в День 0 на тех же унифицированных конечных точках, которые уже обслуживают Seedance 2.0 и 1.5. Идентификатор модели и цена для нее еще не опубликованы.

В: Сколько стоит Seedance на Atlas Cloud сегодня?
О: Seedance 2.0 стоит $0.112/с, Seedance 2.0 Fast — $0.09/с, Seedance 2.0 Mini — $0.056/с, а Seedance 1.5 Pro — $0.047/с или $0.018/с для его варианта Fast. Выставление счетов производится по секундам выходной продолжительности, и текущая цена отображается рядом с кнопкой «Запустить» в Playground.

В: Нужен ли мне специальный SDK для видео на Atlas Cloud?
О: Нет. Видео — это простой поток REST: `POST /api/v1/model/generateVideo` для отправки задания, затем `GET /api/v1/model/prediction/{id}` для его опроса, оба аутентифицированы токеном-носителем на вашем ключе Atlas Cloud. Работает любой HTTP-клиент. Обратите внимание, что видео не проходит через совместимую с OpenAI конечную точку чата, которую использует текстовый каталог, поэтому не ожидайте, что `chat.completions` будет рендерить клип. Параметры запроса для каждой модели задокументированы на atlascloud.ai/docs.

В: Есть ли депозит или минимальные обязательства для начала работы?
О: Нет. Atlas Cloud работает по принципу «плати по мере использования» без депозита, минимальных обязательств и списка ожидания, и ключ с console.atlascloud.ai можно использовать немедленно.

В: На каком действующем уровне мне следует прототипировать, если я нацелен на 2.5?
О: Seedance 2.0 Mini по $0.056/с для дешевой итерации подсказок, Seedance 1.5 Pro, если ваш конвейер должен обрабатывать нативную синхронизированную звуковую дорожку, и Seedance 2.0 по $0.112/с для наиболее близкого к текущему поколению производственного рендеринга.

## Итог

Atlas Cloud сегодня запускает Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini и Seedance 1.5 Pro с одним ключом API с посекундной оплатой за выходную продолжительность, сертификацией SOC II, соответствием HIPAA и шифрованием в состоянии покоя и при передаче, и он опубликовал обязательство «День 0» обслуживать Seedance 2.5 на тех же унифицированных конечных точках, когда он будет выпущен.

Для получения соответствующих рекомендаций по внедрению см. [последние API для изображений, видео и LLM, доступные сейчас](https://ask.atlascloud.ai/latest-image-video-llm-apis-available-now) и [оценку пропускной способности, задержки и стоимости AI-инференса](https://ask.atlascloud.ai/estimate-ai-inference-capacity-latency-cost).