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
}'
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())
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());
PixVerse V6 Max
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.
POST
/
v1
/
videos
/
generations
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
}'
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())
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());
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.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
}'
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())
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 modelopixverse-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 |
Cabeçalhos da requisição
string
obrigatório
Autenticação Bearer:
Bearer <token>, em que <token> é sua chave de API APIMart.Parâmetros da requisição
string
obrigatório
Deve ser
pixverse-v6-max.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.
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.
integer
padrão:"5"
Duração de saída em segundos, de
1 a 15; padrão: 5.string
padrão:"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.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.string
padrão:"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.boolean
padrão:"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.integer
Semente aleatória, de
0 a 2147483647.Exemplo de imagem para vídeo
{
"model": "pixverse-v6-max",
"prompt": "Make the subject walk forward slowly",
"image_urls": ["https://example.com/start.png"],
"duration": 5,
"resolution": "1080p"
}
Consultar uma tarefa
Substitua o ID da tarefa na requisição abaixo pelotask_id retornado no envio:
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 nemresolution 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:
| 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 … |