agent_idstring
Идентификатор агента для отслеживания бюджета и контроля его соблюдения.
aspect_ratioenum
Соотношение сторон вывода. Seedance учитывает полный набор; Sora использует его только для выбора между портретной и альбомной ориентацией (9:16 / 3:4 -> портретная); Grok игнорирует его (шлюз никогда не передаёт его в xAI). По умолчанию используется собственное значение модели. (9:21 удалено 2026-08-07 — ни одна модель Seedance не поддерживает его; используйте 9:16 для вертикальной ориентации.)
bitrate_modeenum
Только для Seedance 2.x (2.0, 2.0-fast, 2.0-mini, 2.5): битрейт вывода. По умолчанию: standard.
camera_fixedboolean
Только для Seedance 1.5-pro: зафиксируйте камеру, чтобы кадр не смещался.
duration_secondsinteger
Продолжительность для оплаты. По умолчанию используется стандартное значение модели (8s xAI, 5s Seedance, 4s Sora). Диапазон для каждой модели: seedance-1.5-pro 4-12s · seedance-2.0 / 2.0-fast / 2.0-mini 4-15s · seedance-2.5 4-30s · sora-2 ровно 4, 8 или 12 · grok-imagine-video 1-15s.
generate_audioboolean
Только для Seedance: нужно ли генерировать синхронизированную звуковую дорожку. По умолчанию включено для text-to-video и выключено для image/RealFace-условий. Автоматически сгенерированный звук иногда отклоняется модерацией на стороне сервиса («output audio may contain sensitive information») даже для безобидных промптов — передайте false, чтобы пропустить звук и избежать этого сбоя. Игнорируется xAI/Sora.
image_urlstring
Необязательный URL стартового изображения для генерации видео из изображения.
last_frame_urlstring
Seedance 1.5-pro / 2.0 / 2.0-fast / 2.0-mini / 2.5 (2.5 нет в платёжном канале Solana-кошелька): интерполяция первого и последнего кадра. Второй URL изображения, который задаёт ПОСЛЕДНИЙ кадр, чтобы модель интерполировала от image_url (первый кадр) → last_frame_url (последний кадр). Требует image_url; взаимоисключающий с real_face_asset_id.
modelenum
Видеомодель для использования
output_formatenum
Только для Seedance 2.5: выходной контейнер. Все остальные модели возвращают MP4.
promptstringобязательный
Текстовое описание видео для генерации. Например: «красное яблоко медленно вращается на деревянном столе», «колибри зависла возле красного цветка, замедленная съёмка»
real_face_asset_idstring
BytePlus RealFace ID ресурса (из blockrun_realface enroll/list) для генерации видео конкретного реального человека. Только Seedance 2.0 / 2.0-fast / 2.0-mini (не 2.5). Взаимоисключается с image_url.
reference_audiosobject[]
ТОЛЬКО ACCOUNT RAIL. Аудиореференсные клипы (1-3), те же модели. Требует референсное изображение или видео в дополнение. Списывается по тарифу 0.3x от лимита видеоклипа (15.2 с в семействе 2.0, 30.2 с в 2.5).
reference_image_urlsstring[]
ТОЛЬКО ACCOUNT RAIL (BLOCKRUN_API_KEY): шлюзы Base и Solana отклоняют референсные медиа с ошибкой 400. Референсные изображения персонажа/стиля, на которые в промпте ссылаются как 'image 1', 'image 2': до 9 для seedance-2.0 / 2.0-fast / 2.0-mini, 30 для 2.5. Несовместимы с image_url / last_frame_url / real_face_asset_id.
reference_videosobject[]
ТОЛЬКО ACCOUNT RAIL. Клипы-референсы движения (1-3) в семействе seedance-2.0 и 2.5. Каждый клип ТАРИФИЦИРУЕТСЯ ПО ПОТОЛКУ СВОЕЙ МОДЕЛИ (15.2s в семействе 2.0, 30.2s в 2.5) независимо от его реальной длины, так что один клип удорожает рендер 5s 720p примерно в 4 раза (seedance-2.0-mini ~$0.40 -> ~$1.61), ~7x на 2.5, при 480p ещё больше.
resolutionenum
Разрешение вывода. Seedance по умолчанию работает в 720p и тарифицируется по токенам (~2.25x при 1080p, ~9x при 4K); наборы для каждой модели из опубликованной схемы token360: seedance-2.0 480p/720p/1080p/4K · 1.5-pro 480p/720p/1080p · 2.0-fast, 2.0-mini и 2.5 только 480p/720p. grok-imagine-video поддерживает 480p (по умолчанию, $0.05/сек) и 720p ($0.07/сек) и отклоняет более высокие разрешения. Игнорируется только Sora (исключено из запроса).
return_last_frameboolean
Только для Seedance: также возвращает последний кадр в виде URL изображения, чтобы использовать его как seed для следующего клипа в цепочке.
safety_identifierstring
Только для Seedance: непрозрачный, стабильный идентификатор конечного пользователя, передаваемый вышестоящему сервису для атрибуции злоупотреблений. Это не фильтр контента. НЕ помещайте в него персональные данные.
seedinteger
Только для Seedance 1.5-pro: seed для воспроизводимости. Одинаковый seed и одинаковый промпт повторно рендерят один и тот же клип.
watermarkboolean
Только для Seedance: впечатывает водяной знак провайдера в результат. По умолчанию выключено.