# Seedance 2.0 · Clip — /videos/generations

Generación de vídeo con Seedance 2.0 · Clip (asíncrona, precio especial por clip): duration debe ser 5, 10 o 15 segundos (por defecto 15; el vertical 9:16 solo 15), 720P, size=16:9 / 9:16; hasta 9 imágenes de referencia (images: fijan las personas, la escena y el estilo; nómbralas @Image1... en el prompt) y admite fotos de personas reales como referencia; no acepta vídeo ni audio de referencia. Devuelve un id de trabajo (HTTP 202); consulta GET /v1/videos/jobs/{id} hasta status=succeeded y lee el resultado en data[0].url. $1,00 el clip, las tres duraciones al mismo precio; reembolso íntegro si falla.

**Endpoint:** `POST https://nezhagate.com/v1/videos/generations`

## Autenticación
```
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Cuerpo de la petición
| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `model` | string | Sí | ID del modelo; aquí seedance-2.0-clip. |
| `prompt` | string | Sí | Prompt de texto que describe el vídeo, la cámara y el movimiento. Máximo 5000 bytes (UTF-8; un carácter chino cuenta como 3). |
| `duration` | integer | No | La duración debe ser 5, 10 o 15 segundos (por defecto 15, la más larga); el vertical 9:16 solo admite 15 por ahora; cualquier otro valor se rechaza. Alias: seconds. Precio especial por clip: las tres duraciones cuestan lo mismo. |
| `resolution` | string | No | La resolución es solo 720P (también la predeterminada); $1,00 por clip, sin importar la duración. |
| `size` | string | No | Relación de aspecto: 16:9 (horizontal, por defecto; 5 / 10 / 15 s) o 9:16 (vertical; 15 s). Alias: aspect_ratio. |
| `image` | string | No | Imagen a vídeo: incluye una imagen de referencia (URL pública, data: URI o base64); omítela para texto a vídeo. |
| `images` | array | No | Varias imágenes de referencia. Hasta 9. Si superas el límite se rechaza en lugar de recortar. Alias reference_images. |

## Ejemplo de petición
```bash
# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/videos/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "seedance-2.0-clip", "prompt": "a paper crane unfolding over a misty lake", "duration": 15, "resolution": "720P", "size": "16:9"}'
# image-to-video: also pass  "image": "https://example.com/ref.png"
# 2) poll every ~5s until status=succeeded, then read data[0].url
curl https://nezhagate.com/v1/videos/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'
```

## Respuesta
```json
{
  "id": "img_3f9a...c2",
  "object": "video.generation.job",
  "status": "queued",
  "model": "seedance-2.0-clip"
}
```