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 Generación de vídeos
Texto a vídeo y generación desde una sola imagen en 360p / 540p / 720p / 1080p, con duraciones de 1–15 segundos y audio 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 es asíncrono. Tras enviar la solicitud, usa el
task_id devuelto con GET /v1/videos/generations/{task_id} para consultar el estado y el 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());
Funciones del modelo
PixVerse V6 Max es la versión de mayor calidad de imagen de PixVerse V6. Solo admite texto a vídeo y generación desde una sola imagen, usando el mismo modelopixverse-v6-max.
| Modo | Entrada | Relación de aspecto |
|---|---|---|
| Texto a vídeo | Omite image_urls; prompt es obligatorio | Usa aspect_ratio, con 16:9 por defecto |
| Imagen a vídeo | Envía 1 imagen en image_urls; prompt es opcional | Sigue la imagen de entrada; aspect_ratio no tiene efecto |
Cabeceras de la solicitud
string
requerido
Autenticación Bearer:
Bearer <token>, donde <token> es tu clave API de APIMart.Parámetros de la solicitud
string
requerido
Debe ser
pixverse-v6-max.string
Describe el contenido que se generará. Obligatorio en texto a vídeo, hasta 5000 caracteres; opcional en imagen a vídeo, hasta 2048 caracteres.
string[]
Lista de URL de imágenes de entrada. Imagen a vídeo acepta exactamente 1 imagen; enviar 2 o más devuelve HTTP 400 de forma síncrona. Omite este campo para texto a vídeo.Las imágenes deben ser accesibles públicamente por HTTP(S), en formato JPEG, PNG o WebP, de menos de 20 MB y con cada lado de hasta 10000 píxeles.
integer
predeterminado:"5"
Duración de salida en segundos, de
1 a 15; valor predeterminado: 5.string
predeterminado:"540p"
Resolución de salida:
360p, 540p, 720p o 1080p; valor predeterminado: 540p.La salida usa las dimensiones nativas del modelo subyacente; prevalecen las dimensiones realmente devueltas. Entre los tamaños observados en pruebas están 640×360 y 1108×832 (ancho × alto, en píxeles).También se acepta quality. Si se envían ambos campos, resolution tiene prioridad.string
Campo de compatibilidad para la resolución, con los mismos valores que
resolution. Solo se usa si se omite resolution; si se omiten ambos, se usa 540p.string
predeterminado:"16:9"
Solo se aplica a texto a vídeo. Admite
16:9, 9:16, 4:3, 3:4, 1:1, 2:3, 3:2 y 21:9; valor predeterminado: 16:9.Imagen a vídeo siempre sigue la relación de aspecto de la imagen de entrada; este campo no tiene efecto.boolean
predeterminado:"false"
Establece
true para generar audio nativo; por defecto, el vídeo es silencioso. La generación con audio tiene un precio por segundo más alto.Solo se reconoce audio en el nivel superior del cuerpo de la solicitud. metadata.generate_audio_switch no activa el audio ni la tarifa con audio.integer
Semilla aleatoria, de
0 a 2147483647.Ejemplo de imagen a 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 una tarea
Sustituye el ID de tarea de la siguiente solicitud por eltask_id devuelto al enviarla:
curl --request GET \
--url 'https://api.apimart.ai/v1/videos/generations/<task_id>' \
--header 'Authorization: Bearer <token>'
Facturación
El coste es la duración de salida en segundos multiplicada por la tarifa por segundo de la resolución y la opción de audio elegidas. La generación con y sin audio usa tarifas distintas; con audio cuesta más por segundo. Si no se especificaresolution ni quality, tanto la salida como la facturación usan 540p.
Las tarifas actuales se obtienen del endpoint de precios del modelo:
| Opción de audio | Campo de precio |
|---|---|
| Sin audio | Precio de la resolución correspondiente en resolution_paid_prices |
| Con audio | Nivel <resolution>-audio correspondiente en billing_tier_paid_prices |
Funciones no admitidas y errores de parámetros
Las siguientes solicitudes devuelven HTTP 400 de forma síncrona, sin crear una tarea ni cobrar:| Solicitud | Mensaje de error |
|---|---|
Incluye extend_from_task_id | pixverse-v6-max does not support video extend …; use pixverse-v6 instead |
Incluye img_references | pixverse-v6-max does not support multi-image reference … |
Incluye first_frame_image o last_frame_image | pixverse-v6-max does not support first/last frame transition … |
Envía 2 o más imágenes en image_urls | pixverse-v6-max image-to-video takes exactly 1 image in image_urls (got N) |
resolution no es uno de los 4 niveles admitidos | invalid resolution … |
duration supera los 15 segundos | invalid duration … |
En texto a vídeo, aspect_ratio no es una de las 8 relaciones admitidas | invalid aspect_ratio … |