# Seedance 2.0 Mini API

Referencia completa de la API de los modelos de generación de vídeo Seedance 2.0 Mini de ByteDance.

## Variantes del modelo

Esta API admite tres variantes del modelo:

| Modelo | ID | Descripción |
|-------|-----|-------------|
| **Seedance 2.0 Mini Text to Video** | `seedance-v2.0-mini-text-to-video` | Generación económica de vídeo a partir de texto |
| **Seedance 2.0 Mini Image to Video** | `seedance-v2.0-mini-image-to-video` | Animación económica de imágenes con control de movimiento |
| **Seedance 2.0 Mini Reference to Video** | `seedance-v2.0-mini-reference-to-video` | Generación económica de vídeo guiada por imágenes, vídeos y audio de referencia |

## Comparación rápida

| Característica | Valor |
|---------|-------|
| Intervalo de duración | 4-15 segundos |
| Opciones de resolución | 480p, 720p |
| Opciones de relación de aspecto | 21:9, 16:9, 9:16, 1:1, 4:3, 3:4 |
| Compatibilidad con audio | Sí (activada por defecto) |
| Medios de referencia | Imágenes, vídeos y audio para la generación a partir de referencias |
| Control de semilla | No lo admite ningún modelo Seedance 2.0 Mini |

### Relaciones de aspecto admitidas

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

### Opciones de resolución

| Resolución | Descripción |
|------------|-------------|
| `480p` | Definición estándar, procesamiento más rápido |
| `720p` | Alta definición |

## Seedance 2.0 Mini Text to Video

### Punto de conexión

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

### Parámetros de la solicitud

#### Obligatorios

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Debe ser `"seedance-v2.0-mini-text-to-video"` |
| `prompt` | string | Instrucción para generar el vídeo |
| `duration` | integer | Duración del vídeo en segundos enteros (4-15), en incrementos de 1 |
| `resolution` | string | Resolución de salida: `"480p"` o `"720p"` |
| `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` |

#### Opcionales

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `sound` | boolean | Si se debe generar sonido ambiental (por defecto: `true`) |

### Ejemplo de solicitud

```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

### Parámetros de la solicitud

#### Obligatorios

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Debe ser `"seedance-v2.0-mini-image-to-video"` |
| `prompt` | string | Instrucción para generar el vídeo |
| `duration` | integer | Duración del vídeo en segundos enteros (4-15), en incrementos de 1 |
| `resolution` | string | Resolución de salida: `"480p"` o `"720p"` |
| `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` |
| `image_url` | string | Primer fotograma del vídeo |

#### Opcionales

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `image_end_url` | string | URL opcional de la imagen del fotograma final |
| `sound` | boolean | Si se debe generar sonido ambiental (por defecto: `true`) |

### Ejemplo de solicitud

```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

### Parámetros de la solicitud

#### Obligatorios

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Debe ser `"seedance-v2.0-mini-reference-to-video"` |
| `prompt` | string | Instrucción para generar el vídeo. Escribe una instrucción normal sin marcadores o utiliza la función de referencia @ (AT) con `<<<image_N>>>`, `<<<video_N>>>` y `<<<audio_N>>>` para hacer referencia explícita a elementos de las matrices de medios correspondientes |
| `duration` | integer | Duración del vídeo en segundos enteros (4-15), en incrementos de 1 |
| `resolution` | string | Resolución de salida: `"480p"` o `"720p"` |
| `aspect_ratio` | string | Relación de aspecto del vídeo: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` o `"3:4"` |

#### Medios de referencia

Cada solicitud debe incluir al menos una imagen o un vídeo. Envía entre 1 y 9 imágenes cuando uses referencias de imagen. La matriz `images` solo se puede omitir o dejar vacía si `videos` contiene al menos un vídeo de referencia. No se admiten solicitudes solo de audio.

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `images` | string[] | Entre 1 y 9 URL de imágenes de referencia, o una matriz vacía si `videos` no está vacía |
| `videos` | string[] | Hasta 3 URL de vídeos de referencia; cada vídeo debe durar entre 2 y 15 segundos, con una duración total máxima de 15 segundos |
| `audios` | string[] | Hasta 3 URL de audio de referencia; cada clip debe durar entre 2 y 15 segundos, con una duración total máxima de 15 segundos; WAV o MP3, máximo 15 MB por clip; requiere al menos una imagen o un vídeo |

#### Marcadores de referencia @ (AT)

La función de referencia @ (AT) vincula los medios de referencia con la instrucción mediante marcadores numerados `<<<...>>>`. La numeración empieza en `1` de forma independiente para cada tipo de medio y sigue el orden de la matriz correspondiente:

| Marcador | Valor referenciado |
|-------------|------------------|
| `<<<image_1>>>` | `images[0]` |
| `<<<image_2>>>` | `images[1]` |
| `<<<video_1>>>` | `videos[0]` |
| `<<<audio_1>>>` | `audios[0]` |

Cada marcador debe apuntar a un elemento existente en su matriz correspondiente.

#### Opcionales

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `sound` | boolean | Si se debe generar sonido sincronizado. El valor predeterminado es `true` |

### Precios de los vídeos de referencia

Seedance V2.0 Mini Reference-to-Video utiliza la misma estructura de facturación por segundo según la resolución que las demás variantes de referencia Seedance 2.0. Cuando la matriz `videos` contiene al menos un vídeo de referencia, el coste total de generación se multiplica por 2. Este multiplicador se aplica una sola vez, independientemente de la cantidad o duración de los vídeos de referencia subidos.

### Ejemplo de solicitud

```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;
```

## Límites de los medios

Estos límites se aplican a las imágenes del primer y último fotograma y a los medios de referencia de los modelos de esta página.

| Medio | Formatos | Límites |
|-------|---------|--------|
| Imágenes | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | Cada imagen debe ocupar menos de 30 MB; la anchura y la altura deben estar entre 300 y 6000 px cada una; la relación anchura/altura debe estar entre 0,4 y 2,5 |
| Vídeos | MP4, MOV | Máximo 200 MB cada uno; anchura y altura entre 300 y 6000 px cada una; relación anchura/altura entre 0,4 y 2,5; frecuencia de fotogramas entre 24 y 60 FPS |
| Audio | WAV, MP3 | Máximo 15 MB por archivo |
| Cuerpo de la solicitud | — | Máximo 64 MB |

El audio y el vídeo de referencia tienen cada uno un límite independiente de duración total de 15 segundos. Sus cantidades también son independientes: hasta 9 imágenes, 3 vídeos y 3 clips de audio. Añadir vídeos no reduce el número de imágenes permitido.

Todos los modelos usan `720p` por defecto, pero se debe seguir proporcionando `resolution`. El interruptor de sonido tiene el valor predeterminado `true`; ni este interruptor ni el audio de referencia cambian el precio. La generación a partir de referencias requiere al menos una imagen o un vídeo; no se admiten solicitudes solo de audio. Subir vídeos de referencia duplica el coste de generación, independientemente de su cantidad o duración.

## Formato de respuesta

### Respuesta inicial

Todos los modelos devuelven un `task_id` para consultar periódicamente el estado:

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

### Respuesta de consulta periódica

Consulta periódicamente `GET /api/v1/video/{taskId}` para comprobar el estado:

```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"
        }
      ]
    }
  }
}
```

### Valores de estado

- `submitted`: Tarea aceptada y pendiente de procesamiento
- `processing`: Generación de vídeo en curso
- `succeed`: Generación de vídeo completada
- `failed`: Error en la generación de vídeo

## Tiempo de procesamiento

El tiempo de procesamiento habitual es de 2 a 6 minutos, según la duración y la resolución.

Consulta el estado cada 5-10 segundos.

## Buenas prácticas

1. **Describe claramente el movimiento**: Incluye descripciones específicas del movimiento en las instrucciones
2. **Selección de resolución**: Usa `480p` para un procesamiento más rápido y `720p` para mayor calidad
3. **Mejora del audio**: Mantén `sound` activado para una experiencia de vídeo más inmersiva
4. **Imagen a vídeo**: Proporciona un primer fotograma nítido mediante `image_url`; usa `image_end_url` cuando necesites controlar los fotogramas inicial y final
5. **Medios de referencia**: Usa imágenes, vídeos y audio de referencia compatibles, y asegúrate de incluir al menos una imagen o un vídeo
6. **Precios de los vídeos de referencia**: Toda solicitud de generación a partir de referencias que contenga al menos un vídeo de referencia se cobra al doble, independientemente de la cantidad o duración de los vídeos subidos
7. **Parámetro de semilla**: No envíes `seed`; los modelos Seedance 2.0 Mini no lo admiten