# Seedance 1.5 Pro API

Referencia completa de la API para los modelos de generación de video Seedance 1.5 Pro.

## Variantes de modelo

Esta API admite dos variantes de modelo:

| Modelo | ID | Descripción |
|-------|-----|-------------|
| **Seedance 1.5 Pro Texto a video** | `seedance-v1.5-pro-text-to-video` | Generación de texto a video de alta calidad |
| **Seedance 1.5 Pro Imagen a video** | `seedance-v1.5-pro-image-to-video` | Animación de imagen con control de movimiento |

## Comparación rápida

| Función | Texto a video | Imagen a video |
|---------|---------------|----------------|
| Entrada | Prompt de texto | Imagen + prompt de texto |
| Rango de duración | 4-12 segundos | 4-12 segundos |
| Opciones de resolución | 480p, 720p, 1080p | 480p, 720p, 1080p |
| Fotograma inicial | No compatible | Obligatorio |
| Fotograma final | No compatible | No compatible |
| Compatibilidad con audio | Opcional | Opcional |
| URL de audio | No compatible | No compatible |

### Relaciones de aspecto compatibles

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

### Opciones de resolución

| Resolución | Descripción |
|------------|-------------|
| `480p` | Estándar definition, procesamiento más rápido |
| `720p` | Alta definición, equilibrio entre calidad y velocidad |
| `1080p` | Full HD, salida de máxima calidad |

## Seedance 1.5 Pro Texto a video

### Punto de conexión

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

### Parámetros de solicitud

#### Obligatorio

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Debe ser `"seedance-v1.5-pro-text-to-video"` |
| `prompt` | string | Prompt de generación de video |
| `duration` | number | Duración del video en segundos (4-12) |
| `resolution` | string | Resolución de salida: `"480p"`, `"720p"`, o `"1080p"` |
| `aspect_ratio` | string | Relación de aspecto del video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, o `"3:4"` |

#### Opcional

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `sound` | boolean | Generar sonido ambiental para el video |
| `camera_fixed` | boolean | Bloquea la posición de la cámara y desactiva el movimiento de cámara |
| `seed` | number | Seed aleatoria para generación reproducible |

### Solicitud de ejemplo

```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-v1.5-pro-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

**Ejemplo solo del cuerpo con parámetros opcionales:**

```javascript
{
  model_name: 'seedance-v1.5-pro-text-to-video',
  prompt: 'A golden retriever running through a sunlit meadow',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  camera_fixed: false,
  seed: 42
}
```

## Seedance 1.5 Pro Imagen a video

### Parámetros de solicitud

#### Obligatorio

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `model_name` | string | Debe ser `"seedance-v1.5-pro-image-to-video"` |
| `prompt` | string | Prompt de generación de video |
| `duration` | number | Duración del video en segundos (4-12) |
| `resolution` | string | Resolución de salida: `"480p"`, `"720p"`, o `"1080p"` |
| `aspect_ratio` | string | Relación de aspecto del video: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, o `"3:4"` |
| `image_url` | string | El primer fotograma del video |

#### Opcional

| Parámetro | Tipo | Descripción |
|-----------|------|-------------|
| `sound` | boolean | Generar sonido ambiental para el video |
| `camera_fixed` | boolean | Bloquea la posición de la cámara y desactiva el movimiento de cámara |
| `seed` | number | Seed aleatoria para generación reproducible |

### Solicitud de ejemplo

```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-v1.5-pro-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

**Ejemplo solo del cuerpo:**

```javascript
{
  model_name: 'seedance-v1.5-pro-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true
}
```

## Formato de respuesta

### Respuesta inicial

Ambos modelos devuelven un `task_id` para consultar 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

Consulta `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 en espera de procesamiento
- `processing`: Generación de video en curso
- `succeed`: Generación de video completada
- `failed`: La generación de video falló

## Tiempo de procesamiento

Tiempo de procesamiento típico: 2-5 minutos, según la duración y la resolución.

Los videos más largos a 1080p pueden tardar hasta 8 minutos. Consulta el estado cada 5-10 segundos.

## Buenas prácticas

1. **Describe el movimiento con claridad**: Incluye descripciones específicas de movimiento en los prompts para obtener resultados más predecibles
2. **Selección de resolución**: Usa `480p` o `720p` para iterar más rápido, y `1080p` para la salida final
3. **Control de cámara**: Establece `camera_fixed: true` cuando quieras que el sujeto sea el foco sin deriva de cámara
4. **Relación de aspecto**: Ajusta la relación de aspecto a tu plataforma objetivo (p. ej., `9:16` para móvil, `16:9` para escritorio)
5. **Reproducibilidad**: Usa el parámetro `seed` para reproducir una generación específica o iterar sobre ella
6. **Calidad de imagen**: Para imagen a video, usa imágenes de entrada de alta resolución y bien iluminadas para obtener mejores resultados