# Seedance 2.0 Mini API

Полный справочник API моделей генерации видео Seedance 2.0 Mini от ByteDance.

## Варианты модели

Этот API поддерживает три варианта модели:

| Модель | ID | Описание |
|-------|-----|-------------|
| **Seedance 2.0 Mini Text to Video** | `seedance-v2.0-mini-text-to-video` | Экономичная генерация видео из текста |
| **Seedance 2.0 Mini Image to Video** | `seedance-v2.0-mini-image-to-video` | Экономичная анимация изображений с управлением движением |
| **Seedance 2.0 Mini Reference to Video** | `seedance-v2.0-mini-reference-to-video` | Экономичная генерация видео по референсным изображениям, видео и аудио |

## Краткое сравнение

| Возможность | Значение |
|---------|-------|
| Диапазон длительности | 4–15 секунд |
| Варианты разрешения | 480p, 720p |
| Варианты соотношения сторон | 21:9, 16:9, 9:16, 1:1, 4:3, 3:4 |
| Поддержка аудио | Да (по умолчанию включено) |
| Референсные материалы | Изображения, видео и аудио для генерации по референсам |
| Управление зерном | Не поддерживается ни одной моделью Seedance 2.0 Mini |

### Поддерживаемые соотношения сторон

`21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`

### Варианты разрешения

| Разрешение | Описание |
|------------|-------------|
| `480p` | Стандартная чёткость, более быстрая обработка |
| `720p` | Высокая чёткость |

## Seedance 2.0 Mini Text to Video

### Конечная точка

```
POST /api/v1/video/task
```

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

#### Обязательные

| Параметр | Тип | Описание |
|-----------|------|-------------|
| `model_name` | string | Должно быть `"seedance-v2.0-mini-text-to-video"` |
| `prompt` | string | Промпт для генерации видео |
| `duration` | integer | Длительность видео в целых секундах (4–15), с шагом 1 |
| `resolution` | string | Разрешение результата: `"480p"` или `"720p"` |
| `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"` |

#### Необязательные

| Параметр | Тип | Описание |
|-----------|------|-------------|
| `sound` | boolean | Генерировать ли звуки окружения (по умолчанию: `true`) |

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

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Seedance 2.0 Mini Image to Video

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

#### Обязательные

| Параметр | Тип | Описание |
|-----------|------|-------------|
| `model_name` | string | Должно быть `"seedance-v2.0-mini-image-to-video"` |
| `prompt` | string | Промпт для генерации видео |
| `duration` | integer | Длительность видео в целых секундах (4–15), с шагом 1 |
| `resolution` | string | Разрешение результата: `"480p"` или `"720p"` |
| `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"` |
| `image_url` | string | Первый кадр видео |

#### Необязательные

| Параметр | Тип | Описание |
|-----------|------|-------------|
| `image_end_url` | string | Необязательный URL изображения последнего кадра |
| `sound` | boolean | Генерировать ли звуки окружения (по умолчанию: `true`) |

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

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Seedance 2.0 Mini Reference to Video

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

#### Обязательные

| Параметр | Тип | Описание |
|-----------|------|-------------|
| `model_name` | string | Должно быть `"seedance-v2.0-mini-reference-to-video"` |
| `prompt` | string | Промпт для генерации видео. Напишите обычный промпт без заполнителей или используйте функцию ссылок @ (AT) с `<<<image_N>>>`, `<<<video_N>>>` и `<<<audio_N>>>`, чтобы явно указать элементы соответствующих массивов материалов |
| `duration` | integer | Длительность видео в целых секундах (4–15), с шагом 1 |
| `resolution` | string | Разрешение результата: `"480p"` или `"720p"` |
| `aspect_ratio` | string | Соотношение сторон видео: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` или `"3:4"` |

#### Референсные материалы

Каждый запрос должен содержать хотя бы одно изображение или видео. При использовании изображений-референсов передавайте от 1 до 9 изображений. Массив `images` можно не передавать или оставить пустым только тогда, когда массив `videos` содержит хотя бы одно референсное видео. Запросы только с аудио не поддерживаются.

| Параметр | Тип | Описание |
|-----------|------|-------------|
| `images` | string[] | От 1 до 9 URL референсных изображений либо пустой массив, если `videos` не пуст |
| `videos` | string[] | До 3 URL референсных видео; длительность каждого видео — 2–15 секунд, суммарная длительность — не более 15 секунд |
| `audios` | string[] | До 3 URL референсного аудио; длительность каждого фрагмента — 2–15 секунд, суммарная длительность — не более 15 секунд; WAV или MP3, не более 15 MB на фрагмент; требуется хотя бы одно изображение или видео |

#### Заполнители ссылок @ (AT)

Функция ссылок @ (AT) связывает референсные материалы с промптом через нумерованные заполнители `<<<...>>>`. Нумерация начинается с `1` независимо для каждого типа материалов и следует порядку соответствующего массива:

| Заполнитель | Значение, на которое он ссылается |
|-------------|------------------|
| `<<<image_1>>>` | `images[0]` |
| `<<<image_2>>>` | `images[1]` |
| `<<<video_1>>>` | `videos[0]` |
| `<<<audio_1>>>` | `audios[0]` |

Каждый заполнитель должен указывать на существующий элемент соответствующего массива.

#### Необязательные

| Параметр | Тип | Описание |
|-----------|------|-------------|
| `sound` | boolean | Генерировать ли синхронизированный звук. По умолчанию `true` |

### Тарификация референсных видео

Seedance V2.0 Mini Reference-to-Video использует ту же посекундную тарификацию с учётом разрешения, что и другие референсные варианты Seedance 2.0. Если массив `videos` содержит хотя бы одно референсное видео, общая стоимость генерации умножается на 2. Этот множитель применяется один раз независимо от количества и длительности загруженных референсных видео.

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

```javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    images: [
      'https://example.com/explorer-reference.jpg',
      'https://example.com/environment-reference.jpg'
    ],
    videos: ['https://example.com/camera-movement-reference.mp4'],
    audios: ['https://example.com/voice-reference.mp3']
  })
});

const { data } = await response.json();
const taskId = data.task_id;
```

## Ограничения материалов

Эти ограничения применяются к изображениям первого и последнего кадров и референсным материалам моделей на этой странице.

| Материал | Форматы | Ограничения |
|-------|---------|--------|
| Изображения | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Каждое изображение должно быть меньше 30 MB; ширина и высота — каждая 300–6000 px; отношение ширины к высоте — 0,4–2,5 |
| Видео | MP4, MOV | Не более 200 MB каждое; ширина и высота — каждая 300–6000 px; отношение ширины к высоте — 0,4–2,5; частота кадров — 24–60 FPS |
| Аудио | WAV, MP3 | Не более 15 MB на файл |
| Тело запроса | — | Не более 64 MB |

Для референсного аудио и референсных видео действует отдельный лимит суммарной длительности — по 15 секунд для каждого типа. Количество также ограничивается независимо: до 9 изображений, 3 видео и 3 аудиофрагментов. Добавление видео не уменьшает допустимое количество изображений.

Все модели по умолчанию используют `720p`, однако `resolution` всё равно необходимо передавать. Переключатель звука по умолчанию равен `true`; ни он, ни референсное аудио не влияют на цену. Для генерации по референсам требуется хотя бы одно изображение или видео; запросы только с аудио не поддерживаются. Загрузка референсных видео удваивает стоимость генерации независимо от их количества и длительности.

## Формат ответа

### Первоначальный ответ

Все модели возвращают `task_id` для периодического опроса:

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}
```

### Ответ при опросе

Периодически вызывайте `GET /api/v1/video/{taskId}` для проверки статуса:

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}
```

### Значения статуса

- `submitted`: Задача принята и ожидает обработки
- `processing`: Идёт генерация видео
- `succeed`: Генерация видео завершена
- `failed`: Ошибка генерации видео

## Время обработки

Обычно обработка занимает 2–6 минут в зависимости от длительности и разрешения.

Проверяйте статус каждые 5–10 секунд.

## Рекомендации

1. **Чётко описывайте движение**: Включайте в промпты конкретные описания движений
2. **Выбор разрешения**: Используйте `480p` для более быстрой обработки и `720p` для более высокого качества
3. **Использование аудио**: Оставляйте `sound` включённым для более выразительных видео
4. **Из изображения в видео**: Передавайте чёткий первый кадр через `image_url`; используйте `image_end_url`, если нужно управлять начальным и конечным кадрами
5. **Референсные материалы**: Используйте поддерживаемые изображения, видео и аудио и обязательно добавляйте хотя бы одно изображение или видео
6. **Тарификация референсных видео**: Любой запрос генерации по референсам, содержащий хотя бы одно референсное видео, оплачивается по двойному тарифу независимо от количества и длительности загруженных видео
7. **Параметр зерна**: Не передавайте `seed`; модели Seedance 2.0 Mini его не поддерживают