Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

Аутентификация

Authorization
string
обязательно
Все эндпоинты API требуют аутентификации через Bearer TokenПолучите ваш API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

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

model
string
обязательно
Имя модели генерации видеоПоддерживаемые модели:
  • doubao-seedance-2.0 — стандартная версия, поддерживает текст-в-видео, изображение-в-видео, видео из первого/последнего кадра, референсное видео, референсное аудио и видео со звуком
  • doubao-seedance-2.0-fast — быстрая версия, те же функции, что и стандартная, с более высокой скоростью генерации
  • doubao-seedance-2.0-face — поддерживает загрузку реальных людей, те же функции, что и стандартная версия
  • doubao-seedance-2.0-fast-face — поддерживает загрузку реальных людей, те же функции, что и быстрая версия
prompt
string
Описание содержимого видеоОбязательно для генерации текст-в-видео; необязательно для изображение-в-видео или видео-референс-в-видеоРекомендуется чётко указывать объект, действие, движение камеры и стиль для лучших результатов генерации
Длина промпта ограничена 4000 символами, но рекомендуется до 500 символов.
Пример: "A kitten yawning at the camera"
duration
integer
по умолчанию:"5"
Длительность видео (в секундах)Поддерживаемый диапазон: от 4 до 15 секундПо умолчанию: 5
size
string
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
  • 1:1 — квадратное
  • 4:3 — традиционное соотношение
  • 3:4 — вертикальное традиционное соотношение
  • 21:9 — сверхширокое
  • adaptive — адаптивное (автоматически соответствует входному изображению/видео)
По умолчанию: 16:9
resolution
string
по умолчанию:"480p"
Разрешение видеоВарианты:
  • 480p — стандартное разрешение
  • 720p — высокое разрешение
  • 1080p — Full HD (поддерживается только моделями doubao-seedance-2.0-face и doubao-seedance-2.0)
По умолчанию: 480p
seed
integer
Случайное seed-значение для управления случайностью генерируемого контента
  • При одинаковом запросе разные seed-значения дадут разные результаты
  • При одинаковом запросе одинаковое seed-значение даст похожие результаты, но точная идентичность не гарантируется
generate_audio
boolean
по умолчанию:"false"
Генерировать ли аудио (видео со звуком)При значении true видео будет содержать сгенерированное ИИ сопровождающее аудиоПо умолчанию: false
return_last_frame
boolean
по умолчанию:"false"
Возвращать ли изображение последнего кадраПри значении true в результате задачи дополнительно будет возвращён URL изображения последнего кадра видео, который можно использовать для непрерывной генерации видеоПо умолчанию: false
tools
array<object>
Список инструментов для расширенных возможностей, таких как веб-поискПример: [{"type": "web_search"}]
image_urls
array<string>
Массив URL изображений для генерации изображение-в-видеоПоддерживает два формата:
  • Обычный URL изображения: https://example.com/cat.jpg
  • URL ассета (одобренный ассет): asset://asset_a
Пример: ["https://example.com/cat.jpg"] или ["asset://asset_a"]
URL ассета поддерживается только моделями doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.
  • image_urls и image_with_roles нельзя использовать одновременно
  • Максимум 9 референсных изображений
image_with_roles
array
Массив изображений с ролями, поддерживает указание первого/последнего кадра
Когда в поле url используется URL ассета, поддерживаются только модели doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.
Пример:
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
Формат URL ассета:
[
  {"url": "asset://asset_a", "role": "reference_image"}
]
  • image_urls и image_with_roles нельзя использовать одновременно
  • При использовании изображений первого/последнего кадра параметры video_urls и audio_urls недоступны
video_urls
array<string>
Массив URL референсных видеоПоддерживает два формата:
  • Обычный URL видео: https://example.com/reference.mp4
  • URL ассета (одобренный ассет): asset://asset_a
Пример: ["https://example.com/reference.mp4"] или ["asset://asset_a"]
URL ассета поддерживается только моделями doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.
  • При использовании изображений первого/последнего кадра (image_with_roles) референсные видео недоступны
  • Максимум 3 референсных видео, общая длительность не более 15 секунд
  • Разрешение референсного видео должно быть в диапазоне от 480P до 720P
  • Референсные видео не должны содержать реальных людей
audio_urls
array<string>
Массив URL референсного аудиоПоддерживает два формата:
  • Обычный URL аудио: https://example.com/speech.wav
  • URL ассета (одобренный ассет): asset://asset_a
Пример: ["https://example.com/speech.wav"] или ["asset://asset_a"]
URL ассета поддерживается только моделями doubao-seedance-2.0 и doubao-seedance-2.0-fast. Другие модели не поддерживают его.
  • При использовании изображений первого/последнего кадра (image_with_roles) референсное аудио недоступно
  • Максимум 3 файла референсного аудио, общая длительность не более 15 секунд
  • Референсное аудио должно использоваться вместе с референсными изображениями или референсными видео

Ответ

code
integer
Код состояния ответа, 200 при успехе
data
array
Массив данных ответа

Сценарии использования

Сценарий 1: текст-в-видео

{
  "model": "doubao-seedance-2.0",
  "prompt": "A kitten yawning at the camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "seed": 42,
  "generate_audio": true
}

Сценарий 2: изображение-в-видео (первый кадр)

{
  "model": "doubao-seedance-2.0",
  "prompt": "The kitten stands up and walks toward the camera",
  "image_urls": ["https://example.com/cat.jpg"],
  "duration": 5
}

Сценарий 3: видео из первого/последнего кадра

{
  "model": "doubao-seedance-2.0",
  "prompt": "Transition from day to night",
  "image_with_roles": [
    {"url": "https://example.com/day.jpg", "role": "first_frame"},
    {"url": "https://example.com/night.jpg", "role": "last_frame"}
  ],
  "duration": 5
}

Сценарий 4: видео из референсного видео

{
  "model": "doubao-seedance-2.0",
  "prompt": "Convert the video style to anime style",
  "video_urls": ["https://example.com/reference.mp4"]
}

Сценарий 5: референсное видео + референсное аудио

{
  "model": "doubao-seedance-2.0",
  "prompt": "A scene of a person speaking",
  "video_urls": ["https://example.com/reference.mp4"],
  "audio_urls": ["https://example.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}

Сценарий 6: видео со звуком

{
  "model": "doubao-seedance-2.0",
  "prompt": "A man stops a woman and says: \"Remember, you must never point your finger at the moon.\"",
  "generate_audio": true
}

Сценарий 7: непрерывная генерация видео (возврат последнего кадра)

{
  "model": "doubao-seedance-2.0",
  "prompt": "The kitten continues walking toward the camera",
  "image_urls": ["https://example.com/last_frame_from_prev.png"],
  "return_last_frame": true
}

Сценарий 8: генерация в быстрой версии

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "City nightscape timelapse photography",
  "size": "21:9",
  "duration": 8
}

Сценарий 9: референсные изображения + референсное видео + референсное аудио (мультимодальное видео)

Сочетайте референсные изображения, референсное видео и референсное аудио, чтобы создать иммерсивное рекламное видео от первого лица. Идеально подходит для продвижения товаров, рекламы брендов и других сценариев, требующих объединения материалов из нескольких источников.
{
  "model": "doubao-seedance-2.0",
  "prompt": "Use video 1's first-person perspective throughout, and use audio 1 as the background music throughout. First-person POV fruit tea advertisement for seedance brand 'Peace Apple' apple fruit tea limited edition. First frame is image 1: your hand picks a dewy Aksu red apple with a crisp apple collision sound. 2-4s: quick cut, your hand drops apple chunks into a shaker cup, adds ice and tea base, shakes vigorously, ice collision and shaking sounds sync with upbeat drum beats, background voice: 'Fresh-cut, fresh-shaken'. 4-6s: first-person close-up of the finished product, layered fruit tea poured into a clear cup, your hand gently squeezes cream cap spreading on top, sticks a pink label on the cup, camera zooms in on the layered texture of cream cap and fruit tea. 6-8s: first-person handheld cup raise, you lift the fruit tea from image 2 toward the camera (simulating handing it to the viewer), cup label clearly visible, background voice 'Take a sip of freshness', final frame freezes on image 2. Background voice consistently uses a female tone.",
  "image_urls": [
    "https://example.com/tea_pic1.jpg",
    "https://example.com/tea_pic2.jpg"
  ],
  "video_urls": ["https://example.com/tea_video1.mp4"],
  "audio_urls": ["https://example.com/tea_audio1.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}

Сценарий 10: изображение-в-видео с URL ассета

Одобренные ассеты виртуальных аватаров можно передавать напрямую как референсные изображения без повторной загрузки и повторной модерации.
{
  "model": "doubao-seedance-2.0",
  "prompt": "The character walks naturally on a city street under bright sunshine",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

Сценарий 11: указание референсного портрета с URL ассета (image_with_roles)

{
  "model": "doubao-seedance-2.0",
  "prompt": "Using the reference portrait, the character walks elegantly toward the camera",
  "image_with_roles": [
    {
      "url": "asset://asset_a",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

Сценарий 12: быстрая версия + URL ассета для изображение-в-видео

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "The character strolls in a park with a gentle breeze",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

Сценарий 13: изображение через URL ассета + референсное видео (перенос движений)

Сочетайте одобренный портретный ассет с референсным видео, чтобы заставить персонажа выполнять заданные движения.
{
  "model": "doubao-seedance-2.0",
  "prompt": "The character dances to the rhythm of the reference video with smooth and natural movements",
  "image_urls": ["https://example.com/dance_reference.jpg", "asset://asset_a"],
  "video_urls": ["https://example.com/dance_reference.mp4", "asset://asset_a"],
  "duration": 8,
  "resolution": "720p"
}
Запрос результатов задачиГенерация видео — это асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи, чтобы запросить прогресс и результаты генерации.

Отличия от версии 1.5 Pro

Функция1.5 Pro2.0 / 2.0 fast
Разрешение480p/720p/1080p480p/720p
Диапазон длительности4-12 с5-15 с
Длительность по умолчанию5 с5 с
Параметр соотношения сторонaspect_ratiosize (новая опция adaptive)
Генерация аудиоПараметр audioПараметр generate_audio
Референсное видеоНе поддерживаетсяПоддерживается через video_urls
Референсное аудиоНе поддерживаетсяПоддерживается через audio_urls
Изображение-в-видеоimage_urls / image_with_rolesimage_urls / image_with_roles
Видео со звукомНе поддерживаетсяПоддерживается через generate_audio
Непрерывное видеоНе поддерживаетсяПоддерживается через return_last_frame
Быстрая версияНе поддерживаетсяПоддерживается через doubao-seedance-2.0-fast