> ## 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.

# Генерация видео Seedance 2.5 Flash

> Видео 480p / 720p длительностью до 30 секунд: текст, мультимодальные референсы, редактирование, продление, первый и последний кадры.

```bash cURL theme={null}
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
}'
```

```python Python theme={null}
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())
```

```javascript JavaScript theme={null}
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());
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_example_seedance25flash"
    }
  ]
}
```

Отправьте `POST /v1/videos/generations`, получите `data[0].task_id`, затем опрашивайте `GET /v1/tasks/{task_id}`.

**Authorization** `string` *required*

Используйте `Authorization: Bearer <token>`, где `<token>` — API-ключ APIMart.

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

**model** `string` *required*

Используйте `seedance-2-5-flash`. Также принимается `doubao-seedance-2-5-flash`. Имя с точкой `seedance-2.5-flash` не поддерживается.

**nsfw\_check** `boolean` (default: false)

Выполнять ли проверку содержимого перед отправкой задачи генерации видео.

* `true`: проверить промпты и входные изображения с помощью `omni-moderation-latest`
* `false` или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)

При обнаружении нарушения возвращается HTTP 400 (`nsfw_content_detected`) без создания задачи и оплаты генерации. Видео и аудиореференсы не проверяются. При сбое службы модерации запрос может продолжиться.

**prompt** `string` *required*

Обязательный промпт. Ссылки на материалы: `@图片1` / `@视频1` / `@音频1`; нумерация с 1 соответствует порядку в каждом массиве материалов.

**resolution** `string` (default: 720p)

Только `480p` / `720p`, по умолчанию `720p`. `1080p`, `2k`, `4k` и другие значения возвращают HTTP 400 при отправке.

**size** `string` (default: adaptive)

`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` (по умолчанию). Псевдоним: `aspect_ratio`. Первый/последний кадр, редактирование и продление требуют `adaptive`.

**duration** `integer`

Целые секунды `4`–`30`; обычный запрос без поля использует `5`. `-1` — автоматическая длительность. Явный `edit` допускает только `-1` или отсутствие поля, которое считается `-1`; длительность следует исходному видео. Автоматический режим резервирует 30 секунд, затем сумма пересчитывается по фактическим токенам.

**generate\_audio** `boolean` (default: true)

Генерация звука, по умолчанию `true`. Псевдоним: `audio`. Это настройка результата, отдельно от входных аудиореференсов `audio_urls`.

**watermark** `boolean` (default: false)

Добавлять водяной знак генерации ИИ, по умолчанию `false`.

**seed** `integer`

Необязательное случайное зерно. Одинаковое зерно не гарантирует идентичный результат.

**output\_format** `string` (default: mp4)

Контейнер результата: `mp4` (по умолчанию) или `mov`.

**omni\_reference\_task\_type** `string` (default: auto)

`auto` (по умолчанию), `reference`, `edit`, `extend`; только для задач с референсами. Явный тип включает проверки при отправке, указанные ниже.

**image\_urls** `string[]`

Массив изображений, все с ролью `reference_image`. Вместе с `image_with_roles` максимум 10 изображений. Для первого и последнего кадров используйте `image_with_roles`.

**image\_with\_roles** `object[]`

Каждый элемент содержит `url` и `role`. Роли: `reference_image`, `first_frame` (не более 1), `last_frame` (не более 1, вместе с первым). С `image_urls` суммарно не более 10; избегайте противоречивых ролей. При наличии `video_urls` / `audio_urls` первый и последний кадры становятся мультимодальными референсами.

**video\_urls** `string[]`

До 5 видео, каждое 2–30 секунд, суммарно до 30 секунд. Исходное видео для редактирования должно длиться 4–30 секунд.

**audio\_urls** `string[]`

До 5 аудиофрагментов, каждый 2–30 секунд, суммарно до 30 секунд. Допускаются только аудиореференсы, без изображений и видео.

**return\_last\_frame** `boolean` (default: false)

При `true` после успеха возвращается изображение последнего кадра в `data.result.videos[].last_frame_url`.

**web\_search** `boolean` (default: false)

Разрешить модели веб-поиск при необходимости, по умолчанию `false`.

**tools** `object[]`

Необязательные инструменты, например `[{"type":"web_search"}]` для веб-поиска.

> [!WARNING]
>
> `draft` / `draft_task_id` не поддерживаются: удалите их, иначе получите HTTP 400 при отправке. Для черновиков используйте [Seedance 2.5](https://docs.apimart.ai/ru/api-reference/videos/seedance-2-5/generation.md).

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

Используйте публично доступные `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`. |

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

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

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

```json theme={null}
{
  "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"
}
```

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

```json theme={null}
{
  "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
}
```

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

```json theme={null}
{
  "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"
}
```

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

```json theme={null}
{
  "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 библиотеки](https://docs.apimart.ai/ru/api-reference/videos/seedance-2-0/private-avatar.md) и имя Flash в примере ниже.

```bash theme={null}
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"
    }
  ]
}'
```

Опрашивайте проверку через единый API задач. После одобрения получите ID `asset://` из списка материалов и передайте его в `image_urls`, `image_with_roles[].url`, `video_urls` или `audio_urls`.

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

Опрашивайте [API статуса](https://docs.apimart.ai/ru/api-reference/tasks/status.md). `pending` / `processing` — обработка, `completed` — успех, `failed` — ошибка. Видео: `data.result.videos[0].url[0]`; поле `url` является массивом.

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
  --header 'Authorization: Bearer <token>'
```

```json theme={null}
{
  "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`.
* Отклонённый запрос не оплачивает генерацию. При ошибке генерации резерв возвращается. Тарифы и скидки см. на [странице цен](https://apimart.ai/pricing).

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

| Ситуация | Действие |
| - | - |
| 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`, согласуйте материалы и промпт с типом задачи. Резерв возвращается. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.