> ## 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 Pembuatan Video

> Teks ke video dan pembuatan dari satu gambar pada 360p / 540p / 720p / 1080p, dengan durasi 1–15 detik dan audio native opsional.

> [!NOTE]
>
> Endpoint ini bekerja secara asinkron. Setelah mengirim permintaan, gunakan `task_id` yang dikembalikan dengan `GET /v1/videos/generations/{task_id}` untuk memeriksa status dan hasil tugas.

```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());
```

## Kemampuan model

PixVerse V6 Max adalah versi PixVerse V6 dengan kualitas gambar lebih tinggi. Hanya mendukung teks ke video dan pembuatan dari satu gambar, keduanya memakai nama model `pixverse-v6-max`.

| Mode | Input | Rasio aspek |
| - | - | - |
| Teks ke video | Jangan kirim `image_urls`; `prompt` wajib | Memakai `aspect_ratio`, default `16:9` |
| Gambar ke video | Kirim 1 gambar dalam `image_urls`; `prompt` opsional | Mengikuti gambar input; `aspect_ratio` tidak berpengaruh |

Untuk transisi bingkai awal/akhir, penggabungan beberapa gambar, dan perpanjangan video, gunakan [PixVerse V6](/id/api-reference/videos/pixverse-v6/generation.md).

## Header permintaan

**Authorization** `string` *required*

Autentikasi Bearer: `Bearer <token>`, dengan `<token>` sebagai API Key APIMart Anda.

## Parameter permintaan

**model** `string` *required*

Harus `pixverse-v6-max`.

**prompt** `string`

Jelaskan konten yang akan dibuat. Wajib untuk teks ke video, maksimal 5000 karakter; opsional untuk gambar ke video, maksimal 2048 karakter.

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

Daftar URL gambar input. Gambar ke video hanya menerima tepat 1 gambar; mengirim 2 atau lebih menghasilkan HTTP 400 secara sinkron. Jangan kirim kolom ini untuk teks ke video.

Gambar harus dapat diakses publik melalui HTTP(S), berformat JPEG, PNG, atau WebP, berukuran kurang dari 20 MB, dengan panjang tiap sisi maksimal 10000 piksel.

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

Durasi output dalam detik, dari `1` hingga `15`; default: `5`.

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

Resolusi output: `360p`, `540p`, `720p`, atau `1080p`; default: `540p`.

Output menggunakan dimensi native model penyedia; dimensi yang benar-benar dikembalikan menjadi acuan. Contoh ukuran yang diamati dalam pengujian mencakup `640×360` dan `1108×832` (lebar × tinggi, dalam piksel).

Kolom `quality` juga diterima. Jika keduanya dikirim, `resolution` diprioritaskan.

**quality** `string`

Kolom kompatibilitas untuk resolusi, dengan nilai yang sama seperti `resolution`. Hanya digunakan jika `resolution` tidak dikirim; jika keduanya tidak dikirim, digunakan `540p`.

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

Hanya berlaku untuk teks ke video. Mendukung `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `2:3`, `3:2`, dan `21:9`; default: `16:9`.

Gambar ke video selalu mengikuti rasio aspek gambar input; kolom ini tidak berpengaruh.

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

Tetapkan `true` untuk menghasilkan audio native; secara default video tanpa suara. Pembuatan dengan audio memiliki tarif per detik lebih tinggi.

Hanya `audio` pada tingkat teratas badan permintaan yang dikenali. `metadata.generate_audio_switch` tidak mengaktifkan audio maupun tarif dengan audio.

**seed** `integer`

Seed acak, dari `0` hingga `2147483647`.

## Contoh gambar ke video

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

Ganti URL contoh dengan URL gambar asli yang dapat diakses publik. Kirim hanya 1 gambar; rasio aspek output mengikuti gambar tersebut.

## Memeriksa tugas

Ganti ID tugas dalam permintaan berikut dengan `task_id` yang dikembalikan saat pengiriman:

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

## Penagihan

Biaya dihitung dari durasi output dalam detik dikalikan tarif per detik sesuai resolusi dan opsi audio. Pembuatan dengan dan tanpa audio memakai tarif terpisah; audio memiliki tarif per detik lebih tinggi.

Jika `resolution` dan `quality` tidak ditentukan, output dan penagihan sama-sama memakai `540p`.

Tarif saat ini tersedia melalui [endpoint harga model](https://api.apimart.ai/api/pricing/model?model=pixverse-v6-max):

| Opsi audio | Kolom harga |
| - | - |
| Tanpa audio | Harga resolusi yang sesuai dalam `resolution_paid_prices` |
| Dengan audio | Tingkat `<resolution>-audio` yang sesuai dalam `billing_tier_paid_prices` |

## Fitur yang tidak didukung dan kesalahan parameter

Permintaan berikut menghasilkan HTTP 400 secara sinkron, tanpa membuat tugas atau mengenakan biaya:

| Permintaan | Pesan kesalahan |
| - | - |
| Menyertakan `extend_from_task_id` | `pixverse-v6-max does not support video extend …; use pixverse-v6 instead` |
| Menyertakan `img_references` | `pixverse-v6-max does not support multi-image reference …` |
| Menyertakan `first_frame_image` atau `last_frame_image` | `pixverse-v6-max does not support first/last frame transition …` |
| Mengirim 2 gambar atau lebih dalam `image_urls` | `pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N)` |
| `resolution` bukan salah satu dari 4 tingkat yang didukung | `invalid resolution …` |
| `duration` melebihi 15 detik | `invalid duration …` |
| `aspect_ratio` teks ke video bukan salah satu dari 8 rasio yang didukung | `invalid aspect_ratio …` |


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