> ## 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 Geração de vídeos

> Texto para vídeo e geração a partir de uma única imagem em 360p / 540p / 720p / 1080p, com duração de 1–15 segundos e áudio nativo opcional.

> [!NOTE]
>
> Este endpoint é assíncrono. Após o envio, use o `task_id` retornado com `GET /v1/videos/generations/{task_id}` para consultar o status e o 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());
```

## Recursos do modelo

PixVerse V6 Max é a versão de maior qualidade de imagem do PixVerse V6. Aceita apenas texto para vídeo e geração a partir de uma única imagem, ambos com o modelo `pixverse-v6-max`.

| Modo | Entrada | Proporção |
| - | - | - |
| Texto para vídeo | Omita `image_urls`; `prompt` é obrigatório | Usa `aspect_ratio`, com padrão `16:9` |
| Imagem para vídeo | Envie 1 imagem em `image_urls`; `prompt` é opcional | Segue a imagem de entrada; `aspect_ratio` não tem efeito |

Para transições entre quadros inicial e final, fusão de várias imagens e extensão de vídeo, use [PixVerse V6](/pt/api-reference/videos/pixverse-v6/generation.md).

## Cabeçalhos da requisição

**Authorization** `string` *required*

Autenticação Bearer: `Bearer <token>`, em que `<token>` é sua chave de API APIMart.

## Parâmetros da requisição

**model** `string` *required*

Deve ser `pixverse-v6-max`.

**prompt** `string`

Descreva o conteúdo a gerar. Obrigatório para texto para vídeo, até 5000 caracteres; opcional para imagem para vídeo, até 2048 caracteres.

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

Lista de URLs de imagens de entrada. Imagem para vídeo aceita exatamente 1 imagem; enviar 2 ou mais retorna HTTP 400 de forma síncrona. Omita este campo para texto para vídeo.

As imagens devem ser acessíveis publicamente por HTTP(S), em JPEG, PNG ou WebP, com menos de 20 MB e cada lado de até 10000 pixels.

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

Duração de saída em segundos, de `1` a `15`; padrão: `5`.

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

Resolução de saída: `360p`, `540p`, `720p` ou `1080p`; padrão: `540p`.

A saída usa as dimensões nativas do modelo subjacente; as dimensões efetivamente retornadas são a referência. Exemplos observados em testes incluem `640×360` e `1108×832` (largura × altura, em pixels).

O campo `quality` também é aceito. Quando ambos são enviados, `resolution` tem prioridade.

**quality** `string`

Campo de compatibilidade para a resolução, com os mesmos valores de `resolution`. Usado apenas quando `resolution` é omitido; se ambos forem omitidos, será usado `540p`.

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

Aplica-se apenas a texto para vídeo. Aceita `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2` e `21:9`; padrão: `16:9`.

Imagem para vídeo sempre segue a proporção da imagem de entrada; este campo não tem efeito.

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

Defina `true` para gerar áudio nativo; por padrão, o vídeo é silencioso. A geração com áudio tem um preço por segundo maior.

Apenas `audio` no nível superior do corpo da requisição é reconhecido. `metadata.generate_audio_switch` não ativa o áudio nem a cobrança da faixa com áudio.

**seed** `integer`

Semente aleatória, de `0` a `2147483647`.

## Exemplo de imagem para 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"
}
```

Substitua a URL de exemplo pela de uma imagem real e acessível publicamente. Envie somente 1 imagem; a proporção de saída seguirá essa imagem.

## Consultar uma tarefa

Substitua o ID da tarefa na requisição abaixo pelo `task_id` retornado no envio:

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

## Cobrança

O custo é a duração de saída em segundos multiplicada pelo preço por segundo da resolução e da opção de áudio escolhidas. Gerações com e sem áudio usam preços distintos; com áudio, o preço por segundo é maior.

Se nem `resolution` nem `quality` forem especificados, a saída e a cobrança usam `540p`.

Os preços atuais são fornecidos pelo [endpoint de preços do modelo](https://api.apimart.ai/api/pricing/model?model=pixverse-v6-max):

| Opção de áudio | Campo de preço |
| - | - |
| Sem áudio | Preço da resolução correspondente em `resolution_paid_prices` |
| Com áudio | Faixa `<resolution>-audio` correspondente em `billing_tier_paid_prices` |

## Recursos não aceitos e erros de parâmetros

As seguintes requisições retornam HTTP 400 de forma síncrona, sem criar uma tarefa nem cobrar:

| Requisição | Mensagem de erro |
| - | - |
| Inclui `extend_from_task_id` | `pixverse-v6-max does not support video extend …; use pixverse-v6 instead` |
| Inclui `img_references` | `pixverse-v6-max does not support multi-image reference …` |
| Inclui `first_frame_image` ou `last_frame_image` | `pixverse-v6-max does not support first/last frame transition …` |
| Envia 2 ou mais imagens em `image_urls` | `pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N)` |
| `resolution` não é uma das 4 opções aceitas | `invalid resolution …` |
| `duration` ultrapassa 15 segundos | `invalid duration …` |
| Em texto para vídeo, `aspect_ratio` não é uma das 8 proporções aceitas | `invalid aspect_ratio …` |


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