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

# PixVerse V6 Max Generación de vídeos

> Texto a vídeo y generación desde una sola imagen en 360p / 540p / 720p / 1080p, con duraciones de 1–15 segundos y audio nativo opcional.

> [!NOTE]
>
> Este endpoint es asíncrono. Tras enviar la solicitud, usa el `task_id` devuelto con `GET /v1/videos/generations/{task_id}` para consultar el estado y el resultado.

```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": "pixverse-v6-max",
    "prompt": "A blue glass marble rolls across a clean white table in morning light",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": true
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "pixverse-v6-max",
        "prompt": "A blue glass marble rolls across a clean white table in morning light",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "audio": True
    }
)
response.raise_for_status()
print(response.json())
```

```javascript JavaScript theme={null}
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "pixverse-v6-max",
    prompt: "A blue glass marble rolls across a clean white table in morning light",
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9",
    audio: true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

## Funciones del modelo

PixVerse V6 Max es la versión de mayor calidad de imagen de PixVerse V6. Solo admite texto a vídeo y generación desde una sola imagen, usando el mismo modelo `pixverse-v6-max`.

| Modo | Entrada | Relación de aspecto |
| - | - | - |
| Texto a vídeo | Omite `image_urls`; `prompt` es obligatorio | Usa `aspect_ratio`, con `16:9` por defecto |
| Imagen a vídeo | Envía 1 imagen en `image_urls`; `prompt` es opcional | Sigue la imagen de entrada; `aspect_ratio` no tiene efecto |

Para transiciones entre fotogramas inicial y final, fusión de varias imágenes y extensión de vídeo, usa [PixVerse V6](/es/api-reference/videos/pixverse-v6/generation.md).

## Cabeceras de la solicitud

**Authorization** `string` *required*

Autenticación Bearer: `Bearer <token>`, donde `<token>` es tu clave API de APIMart.

## Parámetros de la solicitud

**model** `string` *required*

Debe ser `pixverse-v6-max`.

**prompt** `string`

Describe el contenido que se generará. Obligatorio en texto a vídeo, hasta 5000 caracteres; opcional en imagen a vídeo, hasta 2048 caracteres.

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

Lista de URL de imágenes de entrada. Imagen a vídeo acepta exactamente 1 imagen; enviar 2 o más devuelve HTTP 400 de forma síncrona. Omite este campo para texto a vídeo.

Las imágenes deben ser accesibles públicamente por HTTP(S), en formato JPEG, PNG o WebP, de menos de 20 MB y con cada lado de hasta 10000 píxeles.

**duration** `integer` (default: 5)

Duración de salida en segundos, de `1` a `15`; valor predeterminado: `5`.

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

Resolución de salida: `360p`, `540p`, `720p` o `1080p`; valor predeterminado: `540p`.

La salida usa las dimensiones nativas del modelo subyacente; prevalecen las dimensiones realmente devueltas. Entre los tamaños observados en pruebas están `640×360` y `1108×832` (ancho × alto, en píxeles).

También se acepta `quality`. Si se envían ambos campos, `resolution` tiene prioridad.

**quality** `string`

Campo de compatibilidad para la resolución, con los mismos valores que `resolution`. Solo se usa si se omite `resolution`; si se omiten ambos, se usa `540p`.

**aspect\_ratio** `string` (default: 16:9)

Solo se aplica a texto a vídeo. Admite `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2` y `21:9`; valor predeterminado: `16:9`.

Imagen a vídeo siempre sigue la relación de aspecto de la imagen de entrada; este campo no tiene efecto.

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

Establece `true` para generar audio nativo; por defecto, el vídeo es silencioso. La generación con audio tiene un precio por segundo más alto.

Solo se reconoce `audio` en el nivel superior del cuerpo de la solicitud. `metadata.generate_audio_switch` no activa el audio ni la tarifa con audio.

**seed** `integer`

Semilla aleatoria, de `0` a `2147483647`.

## Ejemplo de imagen a vídeo

```json theme={null}
{
  "model": "pixverse-v6-max",
  "prompt": "Make the subject walk forward slowly",
  "image_urls": ["https://example.com/start.png"],
  "duration": 5,
  "resolution": "1080p"
}
```

Sustituye la URL de ejemplo por la de una imagen real y accesible públicamente. Envía solo 1 imagen; la relación de aspecto de salida seguirá esa imagen.

## Consultar una tarea

Sustituye el ID de tarea de la siguiente solicitud por el `task_id` devuelto al enviarla:

```bash theme={null}
curl --request GET \
  --url 'https://api.apimart.ai/v1/videos/generations/<task_id>' \
  --header 'Authorization: Bearer <token>'
```

## Facturación

El coste es la duración de salida en segundos multiplicada por la tarifa por segundo de la resolución y la opción de audio elegidas. La generación con y sin audio usa tarifas distintas; con audio cuesta más por segundo.

Si no se especifica `resolution` ni `quality`, tanto la salida como la facturación usan `540p`.

Las tarifas actuales se obtienen del [endpoint de precios del modelo](https://api.apimart.ai/api/pricing/model?model=pixverse-v6-max):

| Opción de audio | Campo de precio |
| - | - |
| Sin audio | Precio de la resolución correspondiente en `resolution_paid_prices` |
| Con audio | Nivel `<resolution>-audio` correspondiente en `billing_tier_paid_prices` |

## Funciones no admitidas y errores de parámetros

Las siguientes solicitudes devuelven HTTP 400 de forma síncrona, sin crear una tarea ni cobrar:

| Solicitud | Mensaje de error |
| - | - |
| Incluye `extend_from_task_id` | `pixverse-v6-max does not support video extend …; use pixverse-v6 instead` |
| Incluye `img_references` | `pixverse-v6-max does not support multi-image reference …` |
| Incluye `first_frame_image` o `last_frame_image` | `pixverse-v6-max does not support first/last frame transition …` |
| Envía 2 o más imágenes en `image_urls` | `pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N)` |
| `resolution` no es uno de los 4 niveles admitidos | `invalid resolution …` |
| `duration` supera los 15 segundos | `invalid duration …` |
| En texto a vídeo, `aspect_ratio` no es una de las 8 relaciones admitidas | `invalid aspect_ratio …` |


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