curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
seedance-2-5-flash
Генерация видео Seedance 2.5 Flash
Видео 480p / 720p длительностью до 30 секунд: текст, мультимодальные референсы, редактирование, продление, первый и последний кадры.
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": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
POST /v1/videos/generations, получите data[0].task_id, затем опрашивайте GET /v1/tasks/{task_id}.
Параметры запроса
Используйте
seedance-2-5-flash. Также принимается doubao-seedance-2-5-flash. Имя с точкой seedance-2.5-flash не поддерживается.Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
true: проверить промпты и входные изображения с помощьюomni-moderation-latestfalseили параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
nsfw_content_detected) без создания задачи и оплаты генерации. Видео и аудиореференсы не проверяются. При сбое службы модерации запрос может продолжиться.Обязательный промпт. Ссылки на материалы:
@图片1 / @视频1 / @音频1; нумерация с 1 соответствует порядку в каждом массиве материалов.Только
480p / 720p, по умолчанию 720p. 1080p, 2k, 4k и другие значения возвращают HTTP 400 при отправке.16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (по умолчанию). Псевдоним: aspect_ratio. Первый/последний кадр, редактирование и продление требуют adaptive.Целые секунды
4–30; обычный запрос без поля использует 5. -1 — автоматическая длительность. Явный edit допускает только -1 или отсутствие поля, которое считается -1; длительность следует исходному видео. Автоматический режим резервирует 30 секунд, затем сумма пересчитывается по фактическим токенам.Генерация звука, по умолчанию
true. Псевдоним: audio. Это настройка результата, отдельно от входных аудиореференсов audio_urls.auto (по умолчанию), reference, edit, extend; только для задач с референсами. Явный тип включает проверки при отправке, указанные ниже.Массив изображений, все с ролью
reference_image. Вместе с image_with_roles максимум 10 изображений. Для первого и последнего кадров используйте image_with_roles.Каждый элемент содержит
url и role. Роли: reference_image, first_frame (не более 1), last_frame (не более 1, вместе с первым). С image_urls суммарно не более 10; избегайте противоречивых ролей. При наличии video_urls / audio_urls первый и последний кадры становятся мультимодальными референсами.До 5 видео, каждое 2–30 секунд, суммарно до 30 секунд. Исходное видео для редактирования должно длиться 4–30 секунд.
До 5 аудиофрагментов, каждый 2–30 секунд, суммарно до 30 секунд. Допускаются только аудиореференсы, без изображений и видео.
При
true после успеха возвращается изображение последнего кадра в data.result.videos[].last_frame_url.draft / draft_task_id не поддерживаются: удалите их, иначе получите HTTP 400 при отправке. Для черновиков используйте Seedance 2.5.Требования к материалам
Используйте публично доступныеhttp(s) URL или одобренные ID asset://. Разрешение результата и ограничения пикселей входного видео проверяются отдельно.
| Материал | Ограничения |
|---|---|
| Изображения | Суммарно ≤10 в двух полях; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; ширина и высота по 300–6000 px; пропорции 0.4–2.5; каждое <30 MB. |
| Видео | ≤5; MP4 / MOV, видео H.264 / H.265, звук AAC / MP3; каждое 2–30 секунд, суммарно ≤30 секунд; каждое ≤200 MB; ширина и высота по 300–6000 px, пропорции 0.4–2.5, ширина × высота 409,600–8,295,044 пикселей, 24–60 FPS. |
| Аудио | ≤5; WAV / MP3; каждое 2–30 секунд, суммарно ≤30 секунд; каждое ≤15 MB. |
Типы задач и ограничения
| Режим | Использование и ограничения |
|---|---|
| Текст в видео | Передайте prompt без референсов; опустите omni_reference_task_type. |
| Референсы в видео | Передайте материалы, reference необязателен. Действуют обычные ограничения длительности и пропорций. |
| Первый/последний кадр | Используйте image_with_roles; size / aspect_ratio только adaptive. |
| Редактирование | edit; минимум 1 исходное видео 4–30 секунд; пропорции adaptive, duration только -1 или отсутствие поля. |
| Продление | extend; минимум 1 видеореференс; пропорции adaptive. |
auto тип определяется по материалам и промпту, поэтому ошибка ограничений может возникнуть уже при генерации. Даже явный тип может завершиться InvalidParameter.TaskTypeMismatch, если он противоречит промпту.
Примеры запросов
Мультимодальные референсы
{
"model": "seedance-2-5-flash",
"prompt": "Use the composition of @视频1, the subject in @图片1, and @音频1 as background music",
"image_urls": [
"https://example.com/reference.jpg"
],
"video_urls": [
"https://example.com/reference_8s.mp4"
],
"audio_urls": [
"https://example.com/music_5s.mp3"
],
"omni_reference_task_type": "reference",
"duration": 8,
"size": "16:9"
}
Первый и последний кадры
{
"model": "seedance-2-5-flash",
"prompt": "Smoothly transition from the first frame to the last frame",
"image_with_roles": [
{
"url": "https://example.com/first.jpg",
"role": "first_frame"
},
{
"url": "https://example.com/last.jpg",
"role": "last_frame"
}
],
"size": "adaptive",
"duration": 5
}
Редактирование видео
{
"model": "seedance-2-5-flash",
"prompt": "Edit @视频1: replace the cloudy sky with a clear sunset while preserving the camera movement",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "edit",
"size": "adaptive",
"duration": -1,
"output_format": "mov"
}
Продление видео
{
"model": "seedance-2-5-flash",
"prompt": "Extend @视频1 forward: continue the camera movement as the subject walks into the forest",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "extend",
"size": "adaptive",
"duration": 5
}
Приватные материалы
Изображения и видео с лицами реальных людей сначала должны пройти проверку библиотеки материалов; затем используйтеasset://. При загрузке также передайте model: seedance-2-5-flash. См. API библиотеки и имя Flash в примере ниже.
curl --request POST \
--url https://api.apimart.ai/v1/seedance2/private-avatar/assets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"group": {
"name": "flash-assets"
},
"asset_type": "Image",
"assets": [
{
"url": "https://example.com/reference.jpg",
"name": "reference"
}
]
}'
asset:// из списка материалов и передайте его в image_urls, image_with_roles[].url, video_urls или audio_urls.
Статус и результаты
Опрашивайте API статуса.pending / processing — обработка, completed — успех, failed — ошибка. Видео: data.result.videos[0].url[0]; поле url является массивом.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
--header 'Authorization: Bearer <token>'
{
"code": 200,
"data": {
"id": "task_example_seedance25flash",
"status": "completed",
"progress": 100,
"cost": 0.3104,
"credits_cost": 3.104,
"usage": {
"completion_tokens": 38800
},
"result": {
"videos": [
{
"url": [
"https://example.com/generated-video.mp4"
],
"last_frame_url": "https://example.com/generated-last-frame.png"
}
]
}
}
}
| Поле | Значение |
|---|---|
data.usage.completion_tokens | Токены для окончательного расчёта. Могут отсутствовать несколько секунд после завершения; повторите запрос. |
data.cost | Фактическое списание в USD с учётом скидок аккаунта. Используйте возвращённое значение. |
data.credits_cost | Фактически списанные кредиты. |
data.result.videos[].url | Массив URL видео; своевременно скачайте и сохраните. |
data.result.videos[].last_frame_url | URL последнего кадра, только после успеха при запросе return_last_frame: true. |
data.error.message | Причина ошибки. У неуспешной задачи data.cost равен 0, резерв возвращается. |
Расчёт стоимости
- При отправке резерв рассчитывается по секундному тарифу разрешения. С видеореференсами применяется тариф с входным видео: длительность результата плюс суммарная длительность референсов.
- Обычный запрос без
durationрезервирует 5 секунд результата.duration: -1илиeditбез длительности резервирует 30 секунд результата. - После успеха:
data.usage.completion_tokens÷ 1,000,000 × соответствующий тариф за миллион токенов со скидками аккаунта. Разница возвращается или списывается дополнительно. Наличие видеореференсов определяетtokenилиtoken-input; итоговая сумма —data.cost. - Отклонённый запрос не оплачивает генерацию. При ошибке генерации резерв возвращается. Тарифы и скидки см. на странице цен.
Частые ошибки
| Ситуация | Действие |
|---|---|
| HTTP 400: неподдерживаемое разрешение | Только 480p / 720p, не 1080p. |
| HTTP 400: слишком много материалов | До 10 изображений суммарно, 5 видео и 5 аудио; проверьте длительность. |
| HTTP 400: черновик не поддерживается | Удалите draft / draft_task_id. |
| HTTP 400: тип, длительность или пропорции | Проверьте сочетание omni_reference_task_type, duration, size / aspect_ratio. |
HTTP 400: nsfw_content_detected | Обработайте как отказ модерации, прочитайте error.message и измените содержимое. |
| Модель не найдена | Используйте seedance-2-5-flash, а не seedance-2.5-flash. |
Задача failed | Прочитайте data.error.message, согласуйте материалы и промпт с типом задачи. Резерв возвращается. |