Seedance 2.0 API: практическое руководство для разработчиков

Последнее обновление: март 2026

Seedance 2.0 API позволяет разработчикам интегрировать генерацию AI-видео непосредственно в свои приложения. Это руководство охватывает реальные возможности API, его сравнение с альтернативами и начало работы.

Что делает Seedance 2.0 API

Seedance 2.0 API предоставляет программный доступ для генерации видео из текстовых запросов и изображений. Вместо использования веб-интерфейса вы отправляете задания на генерацию через HTTP-запросы, опрашиваете статус завершения и получаете URL-адреса видео.

Основные возможности:

• Генерация видео из текста (модель Seedance 2.0)
• Генерация видео из изображения (анимация референсного изображения)
• Асинхронная отправка заданий с опросом статуса
• Вывод в формате MP4, 1080p HD
• До ~10 секунд на одну генерацию

Что он не делает:

• Нет потокового вывода в реальном времени (генерация требует времени)
• Нет встроенного видеомонтажа
• Нет генерации аудио (в отличие от Google Veo 3)
• Время в очереди генерации варьируется в зависимости от нагрузки

Seedance API vs конкурирующие API

Прежде чем приступить к разработке, стоит честно сравнить ваши варианты.

Когда Seedance API имеет смысл:

• Вам нужно хорошее качество без сложности настройки Google Cloud
• Вы создаете продукт, которому нужно надежное ценообразование на основе кредитов
• Вам нужен доступ к нескольким моделям в одном API (Seedance 1.5 для скорости, 2.0 для качества)

Когда стоит рассмотреть альтернативы:

• Нужно максимально высокое качество → Google Veo 3 (Vertex AI)
• Нужна встроенная генерация аудио → Google Veo 3
• Нужны продвинутые управление камерой → Runway API

Начало работы

Шаг 1: Получите API-ключ

Зарегистрируйтесь на seedance.tv и перейдите в настройки аккаунта. Доступ к API предоставляется на платных тарифах, начиная с $9.9/месяц.

Храните API-ключ как переменную окружения — никогда не встраивайте его в исходные файлы:

export SEEDANCE_API_KEY="ваш-api-ключ"

Шаг 2: Отправьте задание на генерацию

API использует асинхронный паттерн: вы отправляете задание и опрашиваете статус завершения.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.seedance.tv/v1"

def generate_video(prompt: str, model: str = "seedance-2.0"):
    """Отправить задание на генерацию видео из текста."""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": model,
            "aspect_ratio": "16:9",
            "resolution": "1080p"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

Шаг 3: Опрос завершения

def wait_for_completion(job_id: str, poll_interval: int = 5, timeout: int = 300):
    """Опрашивать, пока генерация видео не завершится."""
    start_time = time.time()
    
    while time.time() - start_time < timeout:
        response = requests.get(
            f"{BASE_URL}/videos/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        response.raise_for_status()
        data = response.json()
        
        status = data["status"]
        
        if status == "completed":
            return data["output_url"]
        elif status == "failed":
            raise Exception(f"Генерация не удалась: {data.get('error', 'Неизвестная ошибка')}")
        
        # Все еще обрабатывается
        print(f"Статус: {status} (прошло {int(time.time() - start_time)}с)")
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Генерация не завершилась за {timeout} секунд")

# Использование
job_id = generate_video("Медленный проезд камеры по неоновой улице Токио ночью, отражения дождя на мокром асфальте, кинематографичное 1080p")
video_url = wait_for_completion(job_id)
print(f"Видео готово: {video_url}")

Шаг 4: Изображение в видео

Для анимации референсного изображения:

def generate_from_image(image_url: str, prompt: str):
    """Анимировать референсное изображение."""
    response = requests.post(
        f"{BASE_URL}/videos",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "prompt": prompt,
            "model": "seedance-2.0",
            "image_url": image_url,
            "type": "image-to-video",
            "aspect_ratio": "16:9"
        }
    )
    response.raise_for_status()
    return response.json()["job_id"]

Промпт-инжиниринг для API

Качество вывода сильно зависит от структуры промпта. Вот шаблоны, которые стабильно работают:

Хорошая структура промпта для текста в видео:

[Тип кадра], [Описание объекта], [Действие/движение], [Окружение], [Освещение], [Стиль]

Пример:

Крупный план, трекинг, женщина идет по залитой солнцем оливковой роще, волосы развеваются на ветру, теплый послеобеденный свет сквозь листву, кинематографичная малая глубина резкости

Распространенные ошибки, которые тратят кредиты API:

Слишком расплывчато:

Красивое видео

Слишком много конкурирующих элементов:

Мужчина и женщина и собака на пляже, а также закат и волны и горы на заднем плане

Отсутствует описание движения:

Чашка кофе на столе

Лучше: Чашка кофе на деревянном столе, пар медленно поднимается, мягкий естественный свет из окна слева, макрообъектив

Выбор правильной модели:

Рекомендуемый рабочий процесс: Создавайте черновики с seedance-1.5, уточняйте промпт, затем генерируйте финальный вариант с seedance-2.0. Это снижает затраты API на этапе итераций.

Соотношения сторон

ASPECT_RATIOS = {
    "landscape": "16:9",   # YouTube, десктоп, реклама
    "portrait": "9:16",    # TikTok, Instagram Reels, Shorts
    "square": "1:1",       # Посты Instagram
    "cinema": "21:9"       # Кинематографический широкий экран
}

Обработка ошибок

def safe_generate(prompt: str, max_retries: int = 3):
    """Генерация с логикой повторных попыток при временных сбоях."""
    for attempt in range(max_retries):
        try:
            job_id = generate_video(prompt)
            return wait_for_completion(job_id)
        except requests.HTTPError as e:
            if e.response.status_code == 429:
                # Превышен лимит запросов — пауза
                wait = 30 * (attempt + 1)
                print(f"Превышен лимит. Ожидание {wait}с...")
                time.sleep(wait)
            elif e.response.status_code == 402:
                raise Exception("Недостаточно кредитов. Пополните счет на seedance.tv")
            else:
                raise
        except TimeoutError:
            if attempt < max_retries - 1:
                print(f"Тайм-аут на попытке {attempt + 1}, повтор...")
            else:
                raise
    raise Exception("Превышено максимальное количество попыток")

Лимиты запросов и использование кредитов

• Лимит запросов: Зависит от тарифа. Проверьте текущие лимиты в панели управления.
• Кредиты за генерацию: Зависит от модели, длительности и разрешения. Панель управления показывает текущий баланс кредитов.
• Лучшая практика для продакшена: Реализуйте очередь заданий вместо отправки множества одновременных запросов. Постепенная отправка позволяет избежать ошибок превышения лимита и более экономична.

Варианты использования, для которых этот API хорошо подходит

Автоматизация видео для продуктов: Платформы электронной коммерции, генерирующие видео из изображений продуктов в масштабе. Загрузите изображение продукта + промпт с голосом бренда → автоматические видеоклипы для каждого SKU.

Конвейеры для социальных сетей: Системы планирования контента, которые генерируют недельный объем видео из утвержденного списка промптов. Комбинируйте с инструментом очереди видео для автоматической публикации.

Тестирование рекламных креативов: Маркетинговые инструменты, генерирующие несколько визуальных интерпретаций одной концепции для A/B-тестирования. Создайте 5 вариантов рекламной концепции за один пакет.

Создание прототипов: Команды дизайна и продуктов, создающие концепт-видео до перехода к производству. Значительно дешевле традиционного производства для ранней визуализации.

Создание простого конвейера генерации видео

import json
from pathlib import Path

def batch_generate(prompts: list[dict], output_dir: str = "./videos"):
    """Сгенерировать несколько видео из списка конфигураций промптов."""
    Path(output_dir).mkdir(exist_ok=True)
    results = []
    
    for i, config in enumerate(prompts):
        print(f"Генерация {i+1}/{len(prompts)}: {config['name']}")
        
        try:
            # Используйте быструю модель для черновиков, премиум для финалов
            model = "seedance-2.0" if config.get("final") else "seedance-1.5"
            job_id = generate_video(config["prompt"], model=model)
            url = wait_for_completion(job_id)
            
            results.append({
                "name": config["name"],
                "url": url,
                "status": "success"
            })
            print(f"  ✓ {url}")
            
        except Exception as e:
            results.append({
                "name": config["name"],
                "error": str(e),
                "status": "failed"
            })
            print(f"  ✗ Ошибка: {e}")
        
        # Небольшая задержка между отправками
        time.sleep(2)
    
    # Сохранить результаты
    with open(f"{output_dir}/results.json", "w") as f:
        json.dump(results, f, indent=2)
    
    return results

# Пример использования
prompts = [
    {"name": "hero-shot", "prompt": "...", "final": True},
    {"name": "product-demo", "prompt": "...", "final": False},
]
results = batch_generate(prompts)

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

Есть ли у Seedance 2.0 официальный публичный API?

Seedance предоставляет доступ к API в рамках платных тарифов. Проверьте документацию для разработчиков на seedance.tv для получения актуальной информации о доступе и спецификациях конечных точек.

Как работает ценообразование?

Использование API списывается с вашего кредитного баланса. Разные модели стоят разное количество кредитов за генерацию. Проверьте текущие ставки кредитов для каждой модели в панели управления.

Какое время генерации одного видео?

Обычно от 30 секунд до 3 минут в зависимости от сложности модели и загрузки очереди. Seedance 1.5 быстрее; Seedance 2.0 занимает больше времени, но дает более высокое качество.

Можно ли генерировать видео длиннее 10 секунд?

В настоящее время одним API-вызовом — нет. Для более длинного контента создайте несколько клипов и соедините их в вашем приложении с помощью библиотеки обработки видео, такой как moviepy или ffmpeg.

Подходит ли вывод для коммерческого использования?

Проверьте текущие условия обслуживания на seedance.tv для получения информации о коммерческом лицензировании. Как правило, контент, созданный на платных тарифах, лицензируется для коммерческого использования.

Как Seedance API сравнивается с Runway API?

API Runway ($0.05-0.10/сек) предлагает более продвинутое управление камерой и модель Gen-3 Alpha. Seedance API использует ценообразование на основе кредитов, которое более предсказуемо для планирования бюджета. Runway выигрывает в кинематографичности и управлении камерой; Seedance выигрывает в разнообразии моделей и прозрачности цен. Для большинства разработчиков попробуйте оба на вашем конкретном случае — результаты сильно различаются в зависимости от типа контента.

---

Начните создавать

Готовы интегрировать AI-видео в ваше приложение?

Зарегистрироваться на Seedance → — получите бесплатные кредиты для тестирования API, платные тарифы от $9.9/месяц.

• Песочница текст-в-видео — тестируйте промпты перед разработкой
• Песочница изображение-в-видео — тестируйте анимацию изображений
• Детали модели Seedance 2.0 — бенчмарки качества и спецификации