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

# Generación de vídeo Seedance 2.5 Flash

> Genera vídeos 480p / 720p de hasta 30 segundos mediante texto, referencias multimodales, edición, extensión o fotogramas iniciales y finales.

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

Envía con `POST /v1/videos/generations`, lee `data[0].task_id` y consulta `GET /v1/tasks/{task_id}`.

**Authorization** `string` *required*

Usa `Authorization: Bearer <token>`, donde `<token>` es tu clave API de APIMart.

## Parámetros de solicitud

**model** `string` *required*

Usa `seedance-2-5-flash`. También se admite `doubao-seedance-2-5-flash`. El nombre con punto `seedance-2.5-flash` no es compatible.

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

Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.

* `true`: revisar los prompts y las imágenes de entrada con `omni-moderation-latest`
* `false` u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)

Una detección devuelve HTTP 400 (`nsfw_content_detected`) sin crear tarea ni cobrar la generación. No se revisan vídeos ni audios de referencia. La solicitud puede continuar si falla el servicio de moderación.

**prompt** `string` *required*

Prompt obligatorio. Referencia medios con `@图片1` / `@视频1` / `@音频1`; los índices empiezan en 1 y siguen el orden de cada matriz de medios.

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

Solo `480p` / `720p`; valor predeterminado `720p`. `1080p`, `2k`, `4k` y otros valores devuelven HTTP 400 al enviar.

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

Admite `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` (predeterminado). Alias: `aspect_ratio`. Los fotogramas inicial/final, la edición y la extensión requieren `adaptive`.

**duration** `integer`

Segundos enteros `4`–`30`; las solicitudes normales usan `5` si se omite. `-1` permite duración automática. `edit` explícito solo acepta `-1` u omisión, que se convierte en `-1`; la salida sigue la duración de origen. La duración automática reserva 30 segundos y se liquida según los tokens reales.

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

Generar sonido, `true` por defecto. Alias: `audio`. Controla la salida, no las referencias de entrada `audio_urls`.

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

Añadir marca de agua de generación por IA, `false` por defecto.

**seed** `integer`

Semilla aleatoria opcional. Repetirla no garantiza resultados idénticos.

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

Contenedor de salida: `mp4` (predeterminado) o `mov`.

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

`auto` (predeterminado), `reference`, `edit` o `extend`, solo en tareas con referencias. Los tipos explícitos activan las validaciones al enviar descritas a continuación.

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

Matriz de imágenes, todas como `reference_image`. Máximo 10 combinadas con `image_with_roles`. Usa este último campo para los fotogramas inicial y final.

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

Cada elemento incluye `url` y `role`. Roles: `reference_image`, `first_frame` (máximo 1), `last_frame` (máximo 1, junto al inicial). Máximo 10 imágenes con `image_urls`; evita roles contradictorios. Con `video_urls` / `audio_urls`, los fotogramas inicial/final se convierten en imágenes de referencia multimodal.

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

Máximo 5 vídeos, de 2–30 segundos cada uno y 30 segundos en total. Los vídeos de origen para edición deben durar 4–30 segundos.

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

Máximo 5 audios, de 2–30 segundos cada uno y 30 segundos en total. Se admiten referencias solo de audio, sin imágenes ni vídeos.

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

Con `true`, devuelve una imagen del último fotograma tras el éxito en `data.result.videos[].last_frame_url`.

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

Permitir búsquedas web según sea necesario; `false` por defecto.

**tools** `object[]`

Lista opcional de herramientas, por ejemplo `[{"type":"web_search"}]` para búsqueda web.

> [!WARNING]
>
> No se admiten `draft` / `draft_task_id`; elimínalos de la solicitud o recibirás HTTP 400. Para borradores usa [Seedance 2.5](https://docs.apimart.ai/es/api-reference/videos/seedance-2-5/generation.md).

## Requisitos de los medios

Usa URL `http(s)` públicas o ID `asset://` aprobados. La resolución de salida y los límites de píxeles del vídeo de entrada se validan por separado.

| Medio | Límites |
| - | - |
| Imágenes | ≤10 entre ambos campos; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; ancho y alto de 300–6000 px cada uno; proporción 0.4–2.5; `<30 MB` cada una. |
| Vídeos | ≤5; MP4 / MOV, vídeo H.264 / H.265 y audio AAC / MP3; 2–30 segundos cada uno, ≤30 segundos en total; ≤200 MB cada uno; ancho y alto 300–6000 px, proporción 0.4–2.5, ancho × alto 409,600–8,295,044 píxeles, 24–60 FPS. |
| Audio | ≤5; WAV / MP3; 2–30 segundos cada uno, ≤30 segundos en total; ≤15 MB cada uno. |

## Tipos de tarea y restricciones

| Modo | Uso y restricciones |
| - | - |
| Texto a vídeo | Proporciona `prompt` sin referencias y omite `omni_reference_task_type`. |
| Referencias a vídeo | Proporciona referencias; `reference` es opcional. Se mantienen los límites normales de duración y proporción. |
| Fotogramas inicial/final | Usa `image_with_roles`; `size` / `aspect_ratio` debe ser `adaptive`. |
| Edición de vídeo | `edit`; al menos 1 vídeo de origen de 4–30 segundos; proporción `adaptive`, `duration` en `-1` u omitido. |
| Extensión de vídeo | `extend`; al menos 1 vídeo de referencia; proporción `adaptive`. |

Una restricción inválida del tipo explícito devuelve HTTP 400 antes de crear la tarea o cobrar. Con `auto`, el modelo deduce el tipo de los medios y el prompt, por lo que puede fallar durante la generación. Un tipo explícito también puede producir `InvalidParameter.TaskTypeMismatch` si contradice el prompt.

## Ejemplos de solicitudes

### Referencia multimodal

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

### Fotogramas inicial y final

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

### Edición de vídeo

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

### Extensión de vídeo

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

## Recursos privados

Aprueba primero en la biblioteca las imágenes o vídeos con rostros reales y después usa `asset://`. En la carga, `model` también debe ser `seedance-2-5-flash`. Consulta la [API de recursos](https://docs.apimart.ai/es/api-reference/videos/seedance-2-0/private-avatar.md) y usa el nombre Flash del ejemplo.

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

Consulta la revisión con la API unificada de tareas. Tras la aprobación, obtén el ID `asset://` de la lista y úsalo en `image_urls`, `image_with_roles[].url`, `video_urls` o `audio_urls`.

## Estado y resultados

Consulta la [API de estado](https://docs.apimart.ai/es/api-reference/tasks/status.md). `pending` / `processing` indican progreso, `completed` éxito y `failed` fallo. Lee `data.result.videos[0].url[0]`; `url` es una matriz.

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

| Campo | Significado |
| - | - |
| `data.usage.completion_tokens` | Tokens para la liquidación final. Pueden faltar durante unos segundos tras finalizar; vuelve a consultar. |
| `data.cost` | Cargo real en USD con los descuentos de la cuenta. Usa el valor devuelto. |
| `data.credits_cost` | Créditos realmente cobrados. |
| `data.result.videos[].url` | Matriz de URL de vídeo; descarga y guarda pronto. |
| `data.result.videos[].last_frame_url` | URL del último fotograma, solo tras éxito con `return_last_frame: true`. |
| `data.error.message` | Motivo del fallo. En tareas fallidas, `data.cost` es 0 y se reembolsa la reserva. |

## Facturación

* Al enviar se reserva un importe con la tarifa por segundo de la resolución. Las referencias de vídeo usan el nivel con entrada y suman duración de salida y duración total de referencias.
* Sin `duration`, una solicitud normal reserva 5 segundos de salida. `duration: -1`, o `edit` sin duración, reserva 30 segundos de salida.
* Tras el éxito: `data.usage.completion_tokens` ÷ 1,000,000 × tarifa aplicable por millón de tokens, con descuentos de cuenta. Se reembolsa o cobra la diferencia. La presencia de vídeo de referencia determina `token` o `token-input`; el cargo final es `data.cost`.
* Los envíos rechazados no generan cargos de generación. Si la generación falla, se reembolsa la reserva. Consulta la [página de precios](https://apimart.ai/pricing).

## Errores frecuentes

| Situación | Acción |
| - | - |
| HTTP 400: resolución no compatible | Usa `480p` / `720p`, no `1080p`. |
| HTTP 400: demasiadas referencias | Máximo 10 imágenes combinadas, 5 vídeos y 5 audios; comprueba también las duraciones. |
| HTTP 400: borrador no compatible | Elimina `draft` / `draft_task_id`. |
| HTTP 400: tipo, duración o proporción | Revisa `omni_reference_task_type`, `duration`, `size` / `aspect_ratio`. |
| HTTP 400: `nsfw_content_detected` | Trátalo como rechazo de moderación; lee `error.message` y modifica el contenido. |
| Modelo no encontrado | Usa `seedance-2-5-flash`, no `seedance-2.5-flash`. |
| Tarea `failed` | Lee `data.error.message` y ajusta medios y prompt al tipo de tarea. Se reembolsa la reserva. |


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