Перейти к основному содержанию
POST
Отправьте POST /v1/videos/generations, получите data[0].task_id, затем опрашивайте GET /v1/tasks/{task_id}.
string
обязательно
Используйте Authorization: Bearer <token>, где <token> — API-ключ APIMart.

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

string
обязательно
Используйте seedance-2-5-flash. Также принимается doubao-seedance-2-5-flash. Имя с точкой seedance-2.5-flash не поддерживается.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
При обнаружении нарушения возвращается HTTP 400 (nsfw_content_detected) без создания задачи и оплаты генерации. Видео и аудиореференсы не проверяются. При сбое службы модерации запрос может продолжиться.
string
обязательно
Обязательный промпт. Ссылки на материалы: @图片1 / @视频1 / @音频1; нумерация с 1 соответствует порядку в каждом массиве материалов.
string
по умолчанию:"720p"
Только 480p / 720p, по умолчанию 720p. 1080p, 2k, 4k и другие значения возвращают HTTP 400 при отправке.
string
по умолчанию:"adaptive"
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (по умолчанию). Псевдоним: aspect_ratio. Первый/последний кадр, редактирование и продление требуют adaptive.
integer
Целые секунды 4–30; обычный запрос без поля использует 5. -1 — автоматическая длительность. Явный edit допускает только -1 или отсутствие поля, которое считается -1; длительность следует исходному видео. Автоматический режим резервирует 30 секунд, затем сумма пересчитывается по фактическим токенам.
boolean
по умолчанию:"true"
Генерация звука, по умолчанию true. Псевдоним: audio. Это настройка результата, отдельно от входных аудиореференсов audio_urls.
boolean
по умолчанию:"false"
Добавлять водяной знак генерации ИИ, по умолчанию false.
integer
Необязательное случайное зерно. Одинаковое зерно не гарантирует идентичный результат.
string
по умолчанию:"mp4"
Контейнер результата: mp4 (по умолчанию) или mov.
string
по умолчанию:"auto"
auto (по умолчанию), reference, edit, extend; только для задач с референсами. Явный тип включает проверки при отправке, указанные ниже.
string[]
Массив изображений, все с ролью reference_image. Вместе с image_with_roles максимум 10 изображений. Для первого и последнего кадров используйте image_with_roles.
object[]
Каждый элемент содержит url и role. Роли: reference_image, first_frame (не более 1), last_frame (не более 1, вместе с первым). С image_urls суммарно не более 10; избегайте противоречивых ролей. При наличии video_urls / audio_urls первый и последний кадры становятся мультимодальными референсами.
string[]
До 5 видео, каждое 2–30 секунд, суммарно до 30 секунд. Исходное видео для редактирования должно длиться 4–30 секунд.
string[]
До 5 аудиофрагментов, каждый 2–30 секунд, суммарно до 30 секунд. Допускаются только аудиореференсы, без изображений и видео.
boolean
по умолчанию:"false"
При true после успеха возвращается изображение последнего кадра в data.result.videos[].last_frame_url.
Разрешить модели веб-поиск при необходимости, по умолчанию false.
object[]
Необязательные инструменты, например [{"type":"web_search"}] для веб-поиска.
draft / draft_task_id не поддерживаются: удалите их, иначе получите HTTP 400 при отправке. Для черновиков используйте Seedance 2.5.

Требования к материалам

Используйте публично доступные http(s) URL или одобренные ID asset://. Разрешение результата и ограничения пикселей входного видео проверяются отдельно.

Типы задач и ограничения

Нарушение ограничений явного типа возвращает HTTP 400 до создания задачи и списания средств. С auto тип определяется по материалам и промпту, поэтому ошибка ограничений может возникнуть уже при генерации. Даже явный тип может завершиться InvalidParameter.TaskTypeMismatch, если он противоречит промпту.

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

Мультимодальные референсы

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

Редактирование видео

Продление видео

Приватные материалы

Изображения и видео с лицами реальных людей сначала должны пройти проверку библиотеки материалов; затем используйте asset://. При загрузке также передайте model: seedance-2-5-flash. См. API библиотеки и имя Flash в примере ниже.
Опрашивайте проверку через единый API задач. После одобрения получите ID asset:// из списка материалов и передайте его в image_urls, image_with_roles[].url, video_urls или audio_urls.

Статус и результаты

Опрашивайте API статуса. pending / processing — обработка, completed — успех, failed — ошибка. Видео: data.result.videos[0].url[0]; поле url является массивом.

Расчёт стоимости

  • При отправке резерв рассчитывается по секундному тарифу разрешения. С видеореференсами применяется тариф с входным видео: длительность результата плюс суммарная длительность референсов.
  • Обычный запрос без duration резервирует 5 секунд результата. duration: -1 или edit без длительности резервирует 30 секунд результата.
  • После успеха: data.usage.completion_tokens ÷ 1,000,000 × соответствующий тариф за миллион токенов со скидками аккаунта. Разница возвращается или списывается дополнительно. Наличие видеореференсов определяет token или token-input; итоговая сумма — data.cost.
  • Отклонённый запрос не оплачивает генерацию. При ошибке генерации резерв возвращается. Тарифы и скидки см. на странице цен.

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