# API Pixverse V6 Referensi API lengkap untuk model pembuatan video Pixverse V6. Semua varian menggunakan endpoint tugas video terpadu. ## Varian Model | Model | ID | Deskripsi | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | Menghasilkan video dari prompt teks | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | Menganimasikan dari satu gambar frame pertama | | **Pixverse V6 Transition** | `pixverse-v6-transition` | Menghasilkan transisi antara gambar frame pertama dan frame terakhir | | **Pixverse V6 Extend** | `pixverse-v6-extend` | Memperpanjang video yang sudah ada dengan frame baru yang dipandu oleh `prompt` | ## Perbandingan Cepat | Fitur | Text to Video | Image to Video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | Wajib | Wajib | Wajib | Wajib | | `aspect_ratio` | Opsional (default `16:9`); lihat rasio yang didukung di bawah | Tidak digunakan (mengikuti gambar input) | Tidak digunakan (mengikuti gambar input) | Tidak digunakan (mengikuti video input) | | `image_url` | — | Wajib | Wajib (frame pertama) | — | | `image_end_url` | — | — | Wajib (frame terakhir) | — | | `video_url` | — | — | — | Wajib (video sumber) | | `negative_prompt` | — | — | Opsional | Opsional | | `seed` | — | — | Opsional (`0` diperlakukan sebagai default produk) | Opsional | | Durasi | 1–15 detik | 1–15 detik | 1–15 detik | 1–15 detik | | Resolusi | `360p`, `540p`, `720p`, `1080p` | Sama | Sama | Sama | | Audio | Opsional melalui `sound` | Opsional melalui `sound` | Opsional melalui `sound` | Opsional melalui `sound` | Model text-to-video mendukung rasio aspek: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse V6 Text to Video ### Endpoint ``` POST /api/v1/video/task ``` ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `model_name` | string | Harus berupa `"pixverse-v6-text-to-video"` | | `prompt` | string | Prompt pembuatan video | | `duration` | integer | Panjang video dalam detik (`1`–`15`) | | `resolution` | string | Salah satu dari `360p`, `540p`, `720p`, `1080p` | #### Opsional | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `aspect_ratio` | string | Default `16:9`. Salah satu dari `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Apakah akan menghasilkan audio untuk video | ### Contoh Permintaan ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-text-to-video', prompt: 'A cinematic street scene at night with neon reflections', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Image to Video ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `model_name` | string | Harus berupa `"pixverse-v6-image-to-video"` | | `prompt` | string | Prompt pembuatan video | | `duration` | integer | Panjang video dalam detik (`1`–`15`) | | `resolution` | string | Salah satu dari `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL gambar frame pertama | #### Opsional | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `sound` | boolean | Apakah akan menghasilkan audio untuk video | ### Contoh Permintaan ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-image-to-video', prompt: 'Fluid camera pan; maintain subject identity', duration: 6, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Transition Menghasilkan gerakan antara gambar keyframe **pertama** dan **terakhir**. Mendukung negative prompting dan seeding opsional. ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `model_name` | string | Harus berupa `"pixverse-v6-transition"` | | `prompt` | string | Mendeskripsikan gerakan antara dua frame | | `duration` | integer | Panjang video dalam detik (`1`–`15`) | | `resolution` | string | Salah satu dari `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL gambar frame pertama | | `image_end_url` | string | URL gambar frame terakhir | #### Opsional | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `sound` | boolean | Apakah akan menghasilkan audio untuk video | | `negative_prompt` | string | Konten yang ingin dihindari dalam output | | `seed` | integer | Seed keacakan; `0` mengikuti perilaku acak default platform | ### Contoh Permintaan ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-transition', prompt: 'Seamless blend with natural lighting continuity', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, negative_prompt: 'blur, watermark, text overlay', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Extend Melanjutkan klip yang sudah ada. Berikan URL video sumber dan prompt yang menjelaskan bagaimana cerita harus berlanjut. ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `model_name` | string | Harus berupa `"pixverse-v6-extend"` | | `prompt` | string | Mendeskripsikan bagaimana video harus berlanjut | | `duration` | integer | Panjang video dalam detik (`1`–`15`) | | `resolution` | string | Salah satu dari `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL video sumber yang akan diperpanjang | #### Opsional | Parameter | Tipe | Deskripsi | | --------- | ---- | ----------- | | `sound` | boolean | Apakah akan menghasilkan audio untuk video | | `negative_prompt` | string | Konten yang ingin dihindari dalam output | | `seed` | integer | Seed keacakan; `0` mengikuti perilaku acak default platform | ### Contoh Permintaan ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-extend', prompt: 'Continue the walk into the forest clearing', duration: 5, resolution: '720p', video_url: 'https://example.com/source-clip.mp4', sound: false, negative_prompt: 'low quality, jitter', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Format Respons ### Respons Awal ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Respons Polling Poll `GET /api/v1/video/{taskId}` untuk memeriksa status: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### Nilai Status - `submitted`: Tugas diterima dan menunggu untuk diproses - `processing`: Pembuatan video sedang berlangsung - `succeed`: Pembuatan video selesai - `failed`: Pembuatan video gagal ## Praktik Terbaik 1. **Extend**: Gunakan video sumber yang bersih dan stabil agar model dapat melanjutkan gerakan tanpa artefak. 2. **Transition**: Pasangkan `negative_prompt` dengan `seed` saat Anda membutuhkan pengujian transisi yang dapat diulang. 3. **Resolusi**: Cocokkan `resolution` dengan target pengiriman Anda; resolusi yang lebih tinggi membutuhkan waktu pemrosesan lebih lama. 4. **Polling**: Poll setiap 5–10 detik hingga `task_status` menjadi `succeed` atau `failed`.