curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

doubao-seedance-1-5-pro

doubao-seedance-1-5-pro — генерация видео

Асинхронный режим обработки, возвращает ID задачи для последующих запросов
Поддержка генерации видео из текста, из изображения (первый кадр / последний кадр)
Поддержка генерации аудио
Поддержка горизонтального, вертикального и квадратного соотношения сторон

POST

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-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Авторизация

Authorization

string

обязательно

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

Authorization: Bearer YOUR_API_KEY

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

model

string

обязательно

Имя модели генерации видеоПоддерживаемые модели:

doubao-seedance-1-5-pro — версия 1.5 Pro, поддерживает генерацию аудио и первый/последний кадр

prompt

string

обязательно

Описание содержимого видеоПодробно описывайте сцены, действия и стили, чтобы получить лучшие результаты генерацииПример: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"

duration

integer

по умолчанию:"5"

Длительность видео (в секундах)Поддерживаемый диапазон: 4 ~ 12 секундПо умолчанию: 5

aspect_ratio

string

по умолчанию:"16:9"

Соотношение сторон видеоВарианты:

16:9 — горизонтальное
9:16 — вертикальное
1:1 — квадратное
4:3 — традиционное соотношение
3:4 — вертикальное традиционное соотношение
21:9 — сверхширокое

По умолчанию: 16:9

resolution

string

по умолчанию:"720p"

Разрешение видеоВарианты:

480p — стандартное разрешение
720p — высокое разрешение
1080p — Full HD

По умолчанию: 720p

seed

integer

Целочисленное seed-значение для управления случайностью генерируемого контентаДиапазон значений: целое число от -1 до 2^32-1

При одинаковом запросе, если модель получает разные seed-значения (например, seed не указан или установлен в -1, что использует случайное число), будут генерироваться разные результаты
При одинаковом запросе, если модель получает одинаковое seed-значение, будут генерироваться похожие результаты, но идентичность не гарантируется

audio

boolean

по умолчанию:"false"

Генерировать ли аудиоПри значении true видео будет содержать сгенерированное ИИ сопровождающее аудиоПо умолчанию: false

Генерация аудио доступна только в 1.5 Pro, версия 1.0 не поддерживает этот параметр

camerafixed

boolean

по умолчанию:"false"

Зафиксировать ли камеруПри значении true положение камеры остаётся фиксированнымПо умолчанию: false

Комбинации разрешения и соотношения сторон

Разрешение	Поддерживаемые соотношения сторон	Примечания
480p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Все поддерживаются
720p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Все поддерживаются
1080p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Все поддерживаются

image_urls

array<url>

Массив URL изображений для генерации видео из изображенияПравила автоматического распределения ролей:

1 изображение = первый кадр
2 изображения = первый кадр + последний кадр

Пример: ["https://example.com/first.png", "https://example.com/last.png"]

image_urls и image_with_roles нельзя использовать одновременно

image_with_roles

array

Массив изображений с ролями для более точного управления

Показать Описание полей

url

string

обязательно

URL-адрес изображения

role

string

обязательно

Роль изображенияВарианты:

first_frame — изображение первого кадра, используется как начальный кадр видео (поддерживается только одно)
last_frame — изображение последнего кадра, используется как конечный кадр видео (поддерживается только одно)

Пример:

[
  {"url": "https://example.com/start.png", "role": "first_frame"},
  {"url": "https://example.com/end.png", "role": "last_frame"}
]

image_urls и image_with_roles нельзя использовать одновременно
Первый и последний кадр поддерживают только одно изображение каждый

Ответ

code

integer

Код состояния ответа, 200 при успехе

data

array

Массив данных ответа

Показать Элементы массива

status

string

Статус задачи, submitted при первоначальной отправке

task_id

string

Уникальный идентификатор задачи для запроса статуса и результатов

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

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

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand",
  "audio": true
}

Сценарий 2: высококачественное вертикальное короткое видео

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "A girl spinning under cherry blossom trees, petals falling with the wind",
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "audio": true
}

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

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Animate the image with natural dynamic effects",
  "image_urls": ["https://example.com/first.png"],
  "duration": 5,
  "audio": true
}

Сценарий 4: эффект перехода с первым/последним кадром

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Scene transitions from day to night, city lights gradually turning on",
  "image_with_roles": [
    {"url": "https://example.com/day.png", "role": "first_frame"},
    {"url": "https://example.com/night.png", "role": "last_frame"}
  ],
  "duration": 5
}

Запрос результатов задачиГенерация видео — это асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи, чтобы запросить прогресс и результаты генерации.

Отличия от версии 1.0

Функция	1.0 fast/quality	1.5 Pro
Разрешение по умолчанию	1080p	720p
Поддерживаемые разрешения	480p/720p/1080p	480p/720p/1080p
Диапазон длительности	2-12 с	4-12 с
Генерация аудио	Не поддерживается	Поддерживается
Референсное изображение	`reference` (1 изображение)	Не поддерживается

doubao-seedance-1-0-pro — генерация видео doubao-seedance-2.0 — генерация видео

Documentation Index

​Авторизация

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

​Комбинации разрешения и соотношения сторон

​Ответ

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

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

​Сценарий 2: высококачественное вертикальное короткое видео

​Сценарий 3: динамическое видео из первого кадра

​Сценарий 4: эффект перехода с первым/последним кадром

​Отличия от версии 1.0

Авторизация

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

Комбинации разрешения и соотношения сторон

Ответ

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

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

Сценарий 2: высококачественное вертикальное короткое видео

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

Сценарий 4: эффект перехода с первым/последним кадром

Отличия от версии 1.0