Seedance 2.0 Mini

Создавайте видео длительностью 4–15 секунд в 480p или 720p по самой низкой базовой цене в семействе Seedance (см. раздел об оплате): по тексту, первому и последнему кадрам либо референсам — до 9 изображений, 3 видео и 3 аудиофрагментов.

• Асинхронная обработка: запрос создания возвращает ID задачи. Видео будет доступно после её успешного завершения, обычно через несколько минут.
• Четыре варианта ввода: только текст, первый кадр, первый и последний кадры либо произвольное сочетание изображений, видео и аудио. Для аудио нужен хотя бы один референс в виде изображения или видео.
• Только 480p и 720p, по самой низкой базовой цене в семействе Seedance (см. раздел об оплате).
• У этой модели нет поля generate_audio: запрос с ним отклоняется. Для управления звуком используйте Seedance 2.0 или 2.0 Fast.
• Стоимость зависит от разрешения и длительности результата, а также от длительности референсных видео. Задача, завершившаяся ошибкой, не оплачивается.

Открывает модель в API Explorer. Введите свой API-ключ BeatAPI, чтобы создать задачу. Это настоящий запрос: его стоимость спишется с вашего баланса.

Идентификаторы моделей

Все четыре модели Seedance используют один адрес API. Значения ниже взяты непосредственно из контракта шлюза. Только Seedance 2.5 принимает task_type, output_format и seed.

Адрес API и авторизация

POST https://api.beatapi.io/v1/videos/tasks

Передавайте тело запроса в JSON с заголовком Content-Type: application/json. Idempotency-Key необязателен. Для каждого логического запроса используйте уникальное значение длиной не более 255 символов и повторно используйте его только для отправки точно такого же тела. В течение 24 часов повтор с тем же ключом и телом возвращает первый ответ с заголовком Idempotent-Replayed: true. Тот же ключ с другим телом возвращает 409 idempotency_conflict. Ответы, отличные от 2xx, не сохраняются, поэтому повтор после 400 или 402 выполняется заново.

Как выполняется запрос

Режимы ввода

Параметры запроса

Перед созданием задачи шлюз также проверяет следующие сочетания параметров:

• images нельзя сочетать с полями референсных материалов.

Ограничения входных материалов

До создания задачи шлюз проверяет каждый входной материал. Если ограничение нарушено, возвращается 400 bad_request с указанием материала. Средства не списываются.

• Референсные видео должны быть в MP4 или MOV и доступны по общедоступной HTTPS-ссылке с поддержкой запросов диапазона байтов. Если длительность ролика невозможно измерить, запрос всегда отклоняется, поскольку его секунды оплачиваются.
• Размер изображения проверяется, если сервер сообщает его. Используйте JPEG, PNG или WebP. Если модель не сможет использовать файл, задача завершится с bad_request после отправки, а средства будут возвращены.
• Ограничения проверяются в порядке: длительность, стороны, соотношение сторон, число пикселей, частота кадров и размер файла. Сообщение указывает список и индекс материала, начиная с 0, как в ошибках полей: reference_videos[0] is 1.5 seconds long; this model takes reference video of 1.8 to 15 seconds.
• Длительность измеряется с допуском 0,1 секунды. Размер файла проверяется только тогда, когда сервер его сообщает.
• При создании задачи ссылки на изображения и аудио отклоняются только при ответе сервера 4xx или пустом файле, например images[1] could not be downloaded: the URL returned HTTP 404.. Остальные проблемы с этими материалами выявляются после отправки.
• Частота 23.976 FPS считается ниже 24 и отклоняется. Экспортируйте ролик заново с частотой 24 FPS или выше.
• Файл находится на вашем устройстве? Загрузите его через POST /v1/files и передайте полученный data.url.

Совместимость параметров

Проверки выполняются при создании задачи в указанном порядке. Нарушающий любое правило запрос отклоняется с 400 bad_request без списания средств.

Параметры, которые модель не принимает

Эти параметры не игнорируются, а отклоняются до списания средств:

• Поля других видеомоделей, например generate_audio (отсутствует у Mini), seed, task_type, output_format (только Seedance 2.5), watermark, quality, sound, multi_shots или character_orientation → field "generate_audio" is not supported by model seedance-2-mini (с именем переданного поля).
• Имя, не используемое ни одной видеомоделью BeatAPI → unknown field: <name>.

Оценка стоимости

Число видеотокенов задачи рассчитывается как N = W × H × (24 × D + 1 + 24 × R) / 1024. Здесь W × H — размер кадра в пикселях при выбранных разрешении и соотношении сторон (1280 × 720 для 720p 16:9, 864 × 496 для 480p 16:9), D — длительность результата в секундах, R — суммарная длительность референсных видео в секундах (0, если их нет). Цена — это N, умноженное на тариф за миллион видеотокенов: примерно $3.466 без референсного видео и$2.110 с ним, одинаково для 480p и 720p.

Например, 5 секунд в 720p 16:9 без референсного видео: 1280 × 720 × 121 / 1024 = 108 900 токенов, примерно $0.377. Шлюз сам измеряет референсные ролики; передавать их длительность не нужно. Это оценка; зарезервированная и списанная суммы указаны в usage задачи.

Примеры запросов

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-mini",
  "prompt": "A handheld tracking shot through a rain-lit night market, neon reflections on wet stone",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}'

Видео по тексту

Горизонтальный ролик длительностью 5 секунд в 720p.

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-mini",
  "prompt": "A handheld tracking shot through a rain-lit night market, neon reflections on wet stone",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}'

Первый кадр

Видео начинается с переданного изображения.

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-mini",
  "prompt": "Animate the singer with a quick natural camera push-in",
  "images": [
    "https://cdn.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 5,
  "resolution": "720p"
}'

Первый и последний кадры

Видео переходит от первого изображения ко второму.

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-mini",
  "prompt": "The camera pushes in from the bottle on the table to the singer on a neon stage in one continuous move",
  "images": [
    "https://cdn.beatapi.io/samples/smart-bottle.png",
    "https://cdn.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 6,
  "resolution": "720p"
}'

Референсные изображение и аудио

Выступление на основе изображения персонажа и музыкального фрагмента.

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-mini",
  "prompt": "The singer from the first reference image performs on stage in time with the reference music, warm spotlights, slow orbiting camera",
  "reference_images": [
    "https://cdn.beatapi.io/samples/neon-singer.png"
  ],
  "reference_audios": [
    "https://cdn.beatapi.io/samples/neon-singer-preview.mp3"
  ],
  "duration": 8,
  "resolution": "720p"
}'

Референсные изображение, видео и аудио

Замените ссылку собственным MP4 или MOV длительностью не более 15 секунд. Каждая секунда референсного видео оплачивается (см. раздел об оплате).

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-mini",
  "prompt": "A product film: the bottle from the first reference image on a turntable, camera movement like the first reference video, cut to the beat of the reference music",
  "reference_images": [
    "https://cdn.beatapi.io/samples/smart-bottle.png"
  ],
  "reference_videos": [
    "https://your-cdn.example.com/clips/source.mp4"
  ],
  "reference_audios": [
    "https://cdn.beatapi.io/samples/neon-singer-preview.mp3"
  ],
  "duration": 8,
  "resolution": "720p"
}'

Ответы

Создание задачи (201)

Объект задачи. Поле output равно null, пока задача не завершится успешно. Поля с пометкой «во время выполнения» исчезают после завершения задачи.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "seedance-2-mini",
    "capability_version": 1,
    "media_type": "video",
    "model": "seedance-2-mini",
    "status": "queued",
    "stage": "queued",
    "created_at": 1791993600,
    "updated_at": 1791993600,
    "completed_at": null,
    "poll_after_seconds": 8,
    "output": null,
    "usage": {
      "credits_reserved": 0.377421,
      "credits_settled": 0,
      "credits_refunded": 0,
      "credits_charged": 0.377421,
      "billable_duration_seconds": 5
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

Успешно завершённая задача

GET /v1/tasks/{task_id} возвращает HTTP 200 со status: "succeeded" и результатом в data.output.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "seedance-2-mini",
    "capability_version": 1,
    "media_type": "video",
    "model": "seedance-2-mini",
    "status": "succeeded",
    "stage": "succeeded",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": {
      "media": [
        {
          "type": "video",
          "url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.mp4",
          "mime_type": "video/mp4"
        }
      ],
      "r2_url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.mp4"
    },
    "usage": {
      "credits_reserved": 0.377421,
      "credits_settled": 0.377421,
      "credits_refunded": 0,
      "credits_charged": 0.377421,
      "billable_duration_seconds": 5
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

Поля результата

Задача, завершившаяся ошибкой

Если задача завершилась ошибкой, GET /v1/tasks/{task_id} всё равно возвращает HTTP 200: сведения об ошибке находятся в теле ответа. Зарезервированная сумма возвращается полностью, поэтому списания нет.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "video",
    "capability_id": "seedance-2-mini",
    "capability_version": 1,
    "media_type": "video",
    "model": "seedance-2-mini",
    "status": "failed",
    "stage": "failed",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": null,
    "usage": {
      "credits_reserved": 0.377421,
      "credits_settled": 0,
      "credits_refunded": 0.377421,
      "credits_charged": 0,
      "billable_duration_seconds": 5
    },
    "retryable": true,
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": "processing_failed",
    "error_message": "The task failed during processing on our side. Retry; a failed task is refunded."
  }
}

Полный пример

Создайте задачу, дождитесь её завершения с интервалом опроса, указанным сервером, и выведите ссылки на результаты. Задайте BEATAPI_API_KEY в переменной окружения и установите requests.

import os
import time
import uuid
import requests
API = "https://api.beatapi.io"
HEADERS = {"Authorization": f"Bearer {os.environ['BEATAPI_API_KEY']}"}
def create_task(body: dict) -> dict:
    # One Idempotency-Key per logical request: a retry with the same key cannot create a second task.
    headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
    for attempt in range(3):
        response = requests.post(f"{API}/v1/videos/tasks", headers=headers, json=body, timeout=60)
        if response.status_code in (429, 503) and attempt < 2:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        break
    try:
        payload = response.json()
    except ValueError:  # an edge error page is not JSON
        response.raise_for_status()
        raise
    if not response.ok:
        error = payload["error"]
        raise RuntimeError(f"{response.status_code} {error['code']}: {error['message']} (request_id={error.get('request_id')})")
    return payload["data"]
def wait_for_task(task_id: str, timeout_seconds: int = 1800) -> dict:
    deadline = time.monotonic() + timeout_seconds
    while time.monotonic() < deadline:
        response = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
        if response.status_code == 429 or response.status_code >= 500:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        response.raise_for_status()
        task = response.json()["data"]
        if task["status"] in ("succeeded", "failed"):
            return task
        time.sleep(task.get("poll_after_seconds", 5))
    raise TimeoutError(f"task {task_id} is still running; keep polling later")
task = create_task({
  "model": "seedance-2-mini",
  "prompt": "A handheld tracking shot through a rain-lit night market, neon reflections on wet stone",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
})
print("created", task["id"])
task = wait_for_task(task["id"])
if task["status"] == "failed":
    raise SystemExit(f"{task['error_code']}: {task['error_message']}")
for item in task["output"]["media"]:
    print(item["url"])

Оплата

• Цена зависит от разрешения, размеров кадра и длительности видео: больше секунд, более высокое разрешение или больший кадр стоят дороже. Референсные изображения и аудио не добавляют стоимости.
• Без референсного видео ролик 16:9 стоит примерно $0.035 (480p) или$0.075 (720p) за секунду. При другом соотношении сторон цена отличается на несколько процентов.
• При reference_videos ко всему запросу применяется более низкий тариф «с входным видео». Каждая секунда референсного видео учитывается наравне с секундой результата: при 16:9 примерно $0.021 (480p) или$0.046 (720p) за секунду суммарной длительности результата и референсов.
• В таблице ниже указана цена 8-секундных роликов. Строки «с входным видео» также включают референсное видео длиной 8 секунд.
• Цена резервируется при создании задачи. При adaptive резерв рассчитывается для наибольшего кадра выбранного разрешения. Списывается резерв либо фактическая стоимость, если созданное видео оказалось дороже.
• Если задача завершилась ошибкой, в том числе из-за модерации после отправки, средства возвращаются полностью.

Текущие базовые цены совпадают с указанными на странице цен. Если для аккаунта согласована скидка, стоимость будет ниже. Фактически списанная сумма всегда указана в data.usage задачи.

Частые ошибки

Краткий справочник HTTP-ошибок

Ошибки до создания задачи возвращаются с HTTP-статусом, отличным от 2xx, без списания средств. Обрабатывайте error.code или error.retryable; причина указана в message. Полный список и правила повторов приведены в разделе ошибок.

{
  "error": {
    "code": "bad_request",
    "message": "\"prompt\" is required",
    "retryable": false,
    "request_id": "req_5f0c2a9e4b7d4e31"
  }
}