ByteDance: Seedance 1.0 Pro Fast
Seedance 1.0 Pro Fast — отдельно названный профиль Fast для создания видео без звука по тексту и изображению. Он принимает описание сцены или композицию на основе изображения и поддерживает результат длительностью 2–12 секунд, 24 кадра в секунду и отдельные настройки кадрирования.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Seedance 1.0 Pro Fast — профиль Fast с идентификатором doubao-seedance-1-0-pro-fast-251015. Он создаёт видео без звука по письменному описанию сцены или начальной композиции, заданной изображением. Конкретный селектор отличает этот профиль от Seedance 1.0 Pro; слово Fast не означает гарантированное время выполнения отдельной задачи. Выбирайте режим ввода в зависимости от того, что должно задавать сцену, затем сравнивайте полученный клип с заданием.
План по тексту начинается с краткой последовательности: объект и обстановка, действие, траектория камеры и финальный вид. Для демонстрации товара опишите предмет на поверхности, свет на его материале и короткое движение, заканчивающееся на показываемой особенности. Для концепции места действия перейдите от широкого общего плана к узнаваемому центру внимания. Не просите один короткий клип показывать несколько несвязанных сцен, для каждой из которых нужно заново представить объекты и обстановку.
План на основе изображения начинается с элемента image_url в массиве content и текстового указания движения. Подготовьте кадрирование, фон и расположение объектов в изображении, затем укажите, какие элементы движутся и как ведёт себя камера. Так неподвижная композиция становится короткой анимированной сценой. Это подходит для портрета, предмета на столе или подготовленной визуальной концепции, но фактический результат всё равно нужно проверить на сохранение идентичности, формы и движения во всём клипе.
Изображения можно передавать через доступный URL или data URL в Base64. Документированные форматы: JPEG, PNG, WEBP, BMP, TIFF и GIF; размер изображения должен быть меньше 30 MB, оба размера — строго между 300 и 6000 пикселей, а отношение ширины к высоте — строго между 0.4 и 2.5. Выбирайте чистый исходник с различимыми деталями объекта. Руководство по изображениям рекомендует адаптивное кадрирование, поэтому пропорции подготовленного исходника должны соответствовать композиции, которую вы хотите оживить.
Для профиля 1.0 документирована длительность от двух до двенадцати секунд при 24 кадрах в секунду. Разрешение по умолчанию для Pro Fast — 1080p, а сохранённая таблица результатов перечисляет 480p, 720p и 1080p. Руководство по работе исключает 1080p для сценария с изображением-референсом. Фиксированные соотношения сторон: 16:9, 4:3, 1:1, 3:4, 9:16 и 21:9. Подберите разрешение и формат под выбранный режим ввода, а не считайте все сочетания взаимозаменяемыми.
Настройки начального значения генерации и водяного знака позволяют явно зафиксировать параметры запроса. seed — целое число от -1 до 2^32-1; -1 запрашивает случайное значение. Указание неподвижной камеры применимо с условиями: руководство исключает его в сценарии с изображением-референсом и не гарантирует визуальный эффект там, где оно поддерживается. Команды параметров внутри текста переопределяют отдельные необязательные параметры. Согласуйте эти указания, особенно при правке запроса, в описании сцены которого могла остаться старая команда длительности или разрешения.
Расход измеряется в видеотокенах: ширина результата × высота результата × частота кадров × длительность результата / 1024. Завершённая задача сообщает это количество в usage.completion_tokens. Сохраняйте полученное значение расхода вместе с готовым клипом и запрошенными настройками.
Отправка создаёт асинхронную задачу. Сохраните её идентификатор, отслеживайте статус и после успеха получите готовое видео из content.video_url. По документации созданные файлы хранятся семь дней, поэтому сохраняйте готовый материал вместе с текстом запроса и исходным изображением, если оно есть. Проверьте всё действие, движение камеры и финальное кадрирование; если деталь не соответствует заданию, опишите конкретную правку, сохранив удачные части.
Ailoot Ultra · Видео POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015Начало
Seedance 1.0 Pro Fast — отдельно названный профиль Fast для создания видео без звука по тексту и изображению. Он принимает описание сцены или композицию на основе изображения и поддерживает результат длительностью 2–12 секунд, 24 кадра в секунду и отдельные настройки кадрирования.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Видео
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Видео POST /v1/videos
- Входные данные
text,image- Результат
video
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения doubao-seedance-1-0-pro-fast-251015 | По умолчанию— |
Полеcontent | Типarray | ТребованиеОбязательно | Значения и ограничения Условия: Нативные объекты текста и медиа; внешний массив должен быть непустым. Этот общий конструктор Ailoot не проверяет типы вложенных узлов. | По умолчанию— |
Полеduration | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: 2 Максимум: 12 Условия: Основная схема 1.x: 2–12; более позднее общее описание указывает для 1.5 диапазон 4–12 или -1. В примере используется значение 5, документированное в обоих случаях. | По умолчанию5 |
Полеresolution | Типstring | ТребованиеНеобязательно | Значения и ограничения Условия: Подтверждённые значения для генерации видео из текста — 480p и 1080p. При передаче референсного изображения 1080p исключается. Значение 720p в общем перечислении противоречит описанию модели, поэтому поддержка 720p остаётся неустановленной в обоих режимах. | По умолчанию1080p |
Полеratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Условия: Значения по умолчанию зависят от сцены и модели; документация для входного изображения рекомендует adaptive. | По умолчанию— |
Полеservice_tier | Типstring | ТребованиеНеобязательно | Значения и ограничения default, flex Условия: default=online, flex=offline; выберите до создания. | По умолчаниюdefault |
Полеseed | Типinteger | ТребованиеОбязательно | Значения и ограничения Минимум: -1 Максимум: 4 294 967 295 | По умолчанию-1 |
Полеcamerafixed | Типboolean | ТребованиеОбязательно | Значения и ограничения Условия: Требуется Ailoot; управление камерой по референсному изображению документировано как неподдерживаемое, и его действие не гарантируется. | По умолчаниюfalse |
Полеwatermark | Типboolean | ТребованиеОбязательно | Значения и ограничения | По умолчаниюfalse |
Полеexecution_expires_after | Типinteger | ТребованиеОбязательно | Значения и ограничения Минимум: 3 600 Максимум: 259 200 Единица: секунды | По умолчанию172 800 |
Сочетания входных материалов
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактcamerafixed, content, execution_expires_after, model, seed, watermark |
Параметрoptional | Контрактduration, resolution, ratio, service_tier |
Параметрmaterial_types | Контрактtext, image |
Параметрadditional_properties | Контрактtrue |
Параметрvalidation_scope | КонтрактAiloot проверяет типы обязательных полей, непустое значение model и непустой массив content. Остальные поля запроса сохраняются для выбранной модели. |
Параметрimage_constraints | Контракт{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
Псевдонимы метода: /v1/videos/generations
Жизненный цикл: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Создайте один раз и сохраните возвращённые публичные id/polling_url.
Проверяйте исходную задачу; после succeeded скачайте фактический content.video_url, принадлежащий Ailoot.
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Расчётная единица | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Расчётная единица— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияUltra | Шкала ставок— | Прогноз количества— | Расчётная единицаза 1K видеотокенов | Плата Выход · Оценка только для сравнения $0.0012 за 1K видеотокенов |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётная единица— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.0576 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Видео
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-fast-251015","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Получить и сохранить результаты
Ailoot Ultra · Видео
Нативный JSON с публичными id/polling_url. После публикации content.video_url содержит подписанные URL, принадлежащие Ailoot; до публикации выбранные URL результатов очищаются.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Сохраняйте все готовые результаты
Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.
Сохраните каждый фактический URL в content.video_url; index должен указывать на реальный возвращённый результат.
Если нужно проверить исходный ответ
Сохраните исходные ответ, заголовки и id и проверяйте эту операцию; никогда не повторяйте создание с неизвестным исходом.
Поля ответа
| Поле | Тип |
|---|---|
Полеid | Типstring |
Полеprovider_task_id | Типstring |
Полеpolling_url | Типstring |
Полеstatus | Типstring when supplied |
Полеcontent.video_url | Типstring|string[] |
Полеusage | Типobject when supplied |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНедопустимые JSON/model, типы обязательных полей или индекс содержимого. | Следующий шаг |
Ответ401 · authentication_error | УсловиеНедействительный ключ Ailoot API. | Следующий шаг |
Ответ404 · not_found_error | УсловиеЗадача или результат отсутствуют либо не принадлежат тому же пользователю, ключу API или группе. | Следующий шаг |
Ответ502 · result_pending_check | УсловиеИсходная отправка или статус неполны; сохраните исходный ID, не отправляйте повторно. | Следующий шаг |
Ответ503 · result_pending_check | УсловиеИсходные медиа, маршрут или окончательный расчёт проверяются; продолжайте исходную операцию. | Следующий шаг |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra doubao-seedance-1-0-pro-fast-251015
Псевдонимы путей метода
/v1/videos/generations
Связанные ID для вызова
FAQ · ByteDance: Seedance 1.0 Pro Fast
- Какие входные данные и результаты доступны?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- Какие поля использует запрос?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Какие ограничения действуют?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200