# Pixverse V6 API Referência completa da API para os modelos de geração de vídeo Pixverse V6. Todas as variantes usam o endpoint unificado de tarefa de vídeo. ## Variantes do modelo | Model | ID | Descrição | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | Gerar vídeo a partir de um prompt de texto | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | Animar a partir de uma única imagem inicial | | **Pixverse V6 Transition** | `pixverse-v6-transition` | Gerar uma transição entre uma imagem inicial e uma final | | **Pixverse V6 Extend** | `pixverse-v6-extend` | Estender um vídeo existente com novos frames guiados por `prompt` | ## Comparação rápida | Recurso | Texto para vídeo | Imagem para vídeo | Transição | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | Obrigatório | Obrigatório | Obrigatório | Obrigatório | | `aspect_ratio` | Opcional (padrão `16:9`); veja as proporções compatíveis abaixo | Não usado (segue a imagem de entrada) | Não usado (segue as imagens de entrada) | Não usado (segue o vídeo de entrada) | | `image_url` | — | Obrigatório | Obrigatório (imagem inicial) | — | | `image_end_url` | — | — | Obrigatório (imagem final) | — | | `video_url` | — | — | — | Obrigatório (vídeo de origem) | | `negative_prompt` | — | — | Opcional | Opcional | | `seed` | — | — | Opcional (`0` é tratado como padrão do produto) | Opcional | | Duration | 1–15 seconds | 1–15 seconds | 1–15 seconds | 1–15 seconds | | Resolution | `360p`, `540p`, `720p`, `1080p` | Igual | Igual | Igual | | Audio | Opcional via `sound` | Opcional via `sound` | Opcional via `sound` | Opcional via `sound` | Modelos text-to-video aceitam as proporções: `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 ``` ### Parâmetros da requisição #### Obrigatório | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `model_name` | string | Deve ser `"pixverse-v6-text-to-video"` | | `prompt` | string | Prompt de geração de vídeo | | `duration` | integer | Duração do vídeo em segundos (`1`–`15`) | | `resolution` | string | Um de `360p`, `540p`, `720p`, `1080p` | #### Opcional | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `aspect_ratio` | string | Padrão `16:9`. Um de `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | Se deve gerar áudio para o vídeo | ### Exemplo de requisição ```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 ### Parâmetros da requisição #### Obrigatório | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `model_name` | string | Deve ser `"pixverse-v6-image-to-video"` | | `prompt` | string | Prompt de geração de vídeo | | `duration` | integer | Duração do vídeo em segundos (`1`–`15`) | | `resolution` | string | Um de `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL da imagem inicial | #### Opcional | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `sound` | boolean | Se deve gerar áudio para o vídeo | ### Exemplo de requisição ```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 Gera movimento entre uma imagem keyframe **inicial** e **final**. Aceita negative prompting e seeding opcionais. ### Parâmetros da requisição #### Obrigatório | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `model_name` | string | Deve ser `"pixverse-v6-transition"` | | `prompt` | string | Descreve o movimento entre os dois frames | | `duration` | integer | Duração do vídeo em segundos (`1`–`15`) | | `resolution` | string | Um de `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL da imagem inicial | | `image_end_url` | string | URL da imagem final | #### Opcional | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `sound` | boolean | Se deve gerar áudio para o vídeo | | `negative_prompt` | string | Conteúdo a desencorajar no resultado | | `seed` | integer | Seed de aleatoriedade; `0` segue o comportamento aleatório padrão da plataforma | ### Exemplo de requisição ```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 Continua um clipe existente. Forneça a URL do vídeo de origem e um prompt que descreva como a história deve avançar. ### Parâmetros da requisição #### Obrigatório | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `model_name` | string | Deve ser `"pixverse-v6-extend"` | | `prompt` | string | Descreve como o vídeo deve continuar | | `duration` | integer | Duração do vídeo em segundos (`1`–`15`) | | `resolution` | string | Um de `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL do vídeo de origem a estender | #### Opcional | Parâmetro | Tipo | Descrição | | --------- | ---- | ----------- | | `sound` | boolean | Se deve gerar áudio para o vídeo | | `negative_prompt` | string | Conteúdo a desencorajar no resultado | | `seed` | integer | Seed de aleatoriedade; `0` segue o comportamento aleatório padrão da plataforma | ### Exemplo de requisição ```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; ``` ## Formato da resposta ### Resposta inicial ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### Resposta de polling Consulte `GET /api/v1/video/{taskId}` para verificar o 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" } ] } } } ``` ### Valores de status - `submitted`: Tarefa aceita e aguardando processamento - `processing`: Geração de vídeo em andamento - `succeed`: Geração de vídeo concluída - `failed`: Falha na geração de vídeo ## Boas práticas 1. **Extend**: use um vídeo de origem limpo e estável para que o modelo possa continuar o movimento sem artefatos. 2. **Transition**: combine `negative_prompt` com `seed` quando precisar de testes de transição repetíveis. 3. **Resolution**: ajuste `resolution` ao seu alvo de entrega; resoluções maiores levam mais tempo para processar. 4. **Polling**: consulte a cada 5–10 segundos até `task_status` ser `succeed` ou `failed`.