Dos desarrolladores leyeron la documentación de PixVerse esta mañana. Uno implementó la función de prompt negativo. El otro se enteró de que ese parámetro ya no existe.
Ambos estaban leyendo páginas oficiales. Ese es el estado real de la API de PixVerse en 2026: un servicio de generación de video capaz y en rápida evolución, envuelto en una documentación donde las páginas antiguas y las nuevas discrepan en silencio. La mayoría de las preguntas de los desarrolladores sobre la API de PixVerse AI se reducen a dos cosas. ¿Dónde están los documentos que realmente están actualizados? ¿Y cuánto costará un clip una vez que el código funcione?
Esta guía responde ambas. Cada endpoint, parámetro y precio indicado a continuación fue verificado en páginas oficiales esta semana, el 23 de julio de 2026.
Conclusiones clave
- La documentación oficial de la API de PixVerse está en docs.platform.pixverse.ai. Las claves y los créditos están en platform.pixverse.ai. La aplicación de consumo en app.pixverse.ai es un producto separado con facturación separada.
- Cada llamada necesita dos encabezados: API-KEY más un UUID Ai-trace-id nuevo por solicitud. La generación es asíncrona: envía, obtén un video_id, consulta el resultado.
- La documentación se contradice en algunos lugares. Las páginas de guías antiguas aún muestran negative_prompt y water_mark; la referencia de generación actual no tiene ninguno. Cuando las páginas discrepan, confía en la referencia del endpoint.
- La facturación oficial es en créditos ($10 compran 1,000). El mismo modelo V6 se ejecuta medido en Atlas Cloud desde $0.025 por segundo, donde el clip predeterminado de 5 segundos a 720p con audio cuesta $0.30 frente a $0.60 en créditos de paquete.
El mapa de la documentación de la API de PixVerse: dónde están los documentos reales
Buscar la documentación de la API de PixVerse devuelve cuatro superficies propias y una multitud de revendedores. Las cuatro que importan:
| Superficie | URL | Qué cubre |
|---|---|---|
| Documentación de la plataforma | docs.platform.pixverse.ai | Inicio rápido, referencia completa de la API, precios en créditos, referencia de errores, FAQ |
| Consola de desarrollador | platform.pixverse.ai | Crear claves de API, comprar paquetes de créditos, rastrear uso |
| Aplicación de consumo | app.pixverse.ai | La aplicación web. Sus planes, créditos gratuitos y reglas de marca de agua no aplican a la API |
| Servidor MCP oficial | github.com/PixVerseAI/PixVerse-MCP | Envoltorio oficial que permite a los asistentes de IA llamar a PixVerse directamente |
La división que confunde a la gente es app versus plataforma. La app vende planes mensuales desde $10 y otorga créditos gratuitos diarios variables. La plataforma vende créditos de API y membresías en un libro de contabilidad separado. Una suscripción paga de la app no te da nada en el lado de la API, y viceversa.
Un detalle realmente útil se esconde en la documentación de la plataforma: una página de texto plano consolidada llamada PixVerse-api-llm.txt que empaqueta toda la referencia de la API en un solo documento. Pégala en tu asistente de codificación y podrá escribir llamadas a PixVerse según las especificaciones actuales, en lugar de lo que recuerden sus datos de entrenamiento.
Los documentos describen un servicio detrás de "más de 100 millones de creadores y empresas en 175 países". La escala es real. El cambio de versiones que conlleva es la razón por la que este artículo tiene una sección de contradicciones.
Dos formas de usar la API de PixVerse AI hoy en día
La integración con la propia plataforma de PixVerse se explica detalladamente en la siguiente sección. La forma más rápida de probar los modelos primero es a través de un anfitrión: Atlas Cloud ejecuta PixVerse V6 y C1 entre sus más de 400 modelos, facturados por segundo en dólares, sin paquetes de créditos ni marca de agua. La página de la familia PixVerse enumera los nueve endpoints alojados, desde texto a video hasta referencia a video y extensión. Dos formas de acceder: prueba en el playground, luego llama al mismo endpoint desde el código. El punto de partida natural es el playground de texto a video V6.
Método 1: Probar la API de PixVerse V6 en el playground
Antes de escribir código, dedica diez minutos aquí. El playground es el mismo endpoint que llamará tu código, con una cotización de precio adjunta.
- Inicia sesión y abre el playground. El campo de prompt es la única entrada obligatoria.
- Configura duración, calidad y relación de aspecto. Los valores predeterminados son 5 segundos, 720p, 16:9.
- Revisa el interruptor de audio. El sonido está activado por defecto y aumenta la tarifa por segundo.
- Lee el botón Ejecutar. Muestra el costo exacto de tu configuración actual. Con los valores predeterminados es $0.30, por lo que $10 cubren aproximadamente 33 ejecuciones.
- Ejecuta, revisa, descarga. Itera en el prompt hasta que la salida sea satisfactoria, luego mueve esa configuración exacta al código.
Método 2: Llamar a la API de PixVerse V6 desde código
El flujo de trabajo del desarrollador de PixVerse V6 en Atlas Cloud consiste en dos solicitudes HTTP.
Paso 1: Obtén tu clave de API. Crea una clave en la consola de Atlas Cloud y guárdala como variable de entorno, nunca en el código del cliente.
Imagen: Captura de pantalla de la página de claves de API de la consola de Atlas Cloud, que muestra el botón de crear clave y una clave recién generada junto con su control de copia.
Paso 2: Consulta la documentación de la API. Los endpoints, parámetros y autenticación se encuentran en la documentación de la API.
Paso 3: Realiza tu primera solicitud. Envía el trabajo:
plaintext1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "pixverse/v6/text-to-video", 6 "prompt": "Un travelling lento por un mercado nocturno mojado por la lluvia, letreros de neón reflejándose en charcos, vapor subiendo de puestos de comida", 7 "duration": 5, 8 "quality": "720p", 9 "aspect_ratio": "16:9", 10 "sound": true 11 }'
La respuesta devuelve un ID de predicción. Consúltalo hasta que el estado sea completado:
plaintext1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
La respuesta completada contiene la URL del video alojado. El beneficio duradero es la estructura de la solicitud: Atlas Cloud ejecuta una API para todos los modelos, por lo que una clave, un encabezado de autenticación y un bucle de envío y consulta cubren PixVerse hoy y lo que agregues después. Cambiar de modelos significa cambiar la cadena del modelo, nada más.
Dentro de la documentación oficial de la API de PixVerse AI: cómo se ejecuta realmente una llamada
Si te integras con la propia plataforma de PixVerse, la descripción general de la API define un flujo de tres etapas contra el dominio base app-api.pixverse.ai:
| Etapa | Endpoint | Notas |
|---|---|---|
| Carga (solo imagen a video) | POST /openapi/v2/image/upload | Multipart. PNG, WebP o JPEG de menos de 20 MB. Devuelve un entero img_id |
| Generar | POST /openapi/v2/video/text/generate | Cuerpo JSON. Devuelve un video_id |
| Consultar | GET /openapi/v2/video/result/{video_id} | El estado 1 significa terminado, con una url de descarga en la respuesta |
La autenticación requiere dos encabezados en cada llamada. API-KEY contiene la clave de tu consola de la plataforma. Ai-trace-id debe ser un UUID nuevo por solicitud; los documentos advierten que reutilizar uno bloquea el inicio de nuevas generaciones.
La referencia actual de texto a video marca cinco campos obligatorios: prompt (hasta 5,000 caracteres), model, duration, quality y aspect_ratio. La enumeración model acepta ocho valores, de v3.5 a v5.6 más v6 y c1, y los límites de duración siguen la generación: 5 u 8 segundos hasta v5, una opción de 10 segundos en v5.5 y v5.6, y cualquier valor de 1 a 15 segundos en v6 y c1. El audio se activa mediante generate_audio_switch, que por defecto es false. Ese valor predeterminado es importante para el presupuesto: el playground de Atlas Cloud anterior activa el sonido por defecto, por lo que las dos rutas cotizan precios diferentes para lo que parece ser el mismo clip.
La imagen a video agrega primero el paso de carga. No se puede pasar una URL de imagen pública; debes subir el archivo, tomar el img_id devuelto y referenciarlo en el cuerpo de la generación.
Dos datos operativos completan el panorama, ambos de la referencia de errores. Las generaciones concurrentes están limitadas por el nivel de membresía, y una ranura atascada se libera después de unos 10 minutos. Y vale la pena manejar explícitamente los estados de consulta: 7 significa que el prompt activó la moderación de contenido, 8 significa un error del lado del servidor que vale la pena reintentar.
Donde la documentación de la API de PixVerse se contradice
La documentación de la API de PixVerse es una mezcla de referencias de endpoints actuales y páginas de guías antiguas que nunca se actualizaron por completo. Leer la página incorrecta cuesta tiempo real de depuración. Los conflictos que verificamos directamente:
| Tema | Una página de documentación antigua dice | La referencia actual dice |
|---|---|---|
| negative_prompt | Se muestra en los cuerpos de solicitud de ejemplo de la descripción general de la API | No es un campo en el endpoint de generación |
| water_mark | "water_mark": false aparece en los mismos ejemplos | Ausente de la lista de parámetros actual |
| Duración del clip | El README de MCP codifica "5s o 8s" | Cualquier valor de 1 a 15 segundos en v6 y c1 |
| Límite de carga de imagen | Página de solución de problemas: 4000×4000 píxeles | Referencia de carga: 10,000 píxeles |
| Longitud del prompt | Guía práctica: mantener prompts de 25 a 200 palabras | Límite duro de 5,000 caracteres, sin guía de palabras |
Dos reglas cubren las cinco filas. Cuando las páginas discrepan, confía en la referencia del endpoint sobre la página de guía; las referencias llevan las especificaciones actuales, las guías llevan historia. Y cuando los límites discrepan, programa usando el más estricto, por lo tanto 4000 píxeles en las cargas.
La enumeración de versiones merece su propia advertencia. Los nombres de modelos antiguos aún funcionan: v3.5, v4 y v4.5 siguen siendo valores válidos, por lo que las integraciones de la era 2025 no se rompieron. Simplemente pagan de más. A 720p durante 5 segundos sin audio, la tarifa oficial cobra 60 créditos en V4 pero 45 en V6. Si heredas un código base con una cadena de modelo antigua, actualizarla es un cambio de una línea que reduce el costo y mejora la salida. Solo la generación V2 ha desaparecido por completo del acceso de primera parte.
Precios de la API de PixVerse: créditos en la plataforma, dólares en Atlas Cloud
La plataforma oficial de PixVerse factura en créditos, y su página de precios etiqueta las tablas de modelos como "Calculado por segundo". Los paquetes de créditos van desde $10 por 1,000 créditos hasta $5,000 por 500,000, con membresías mensuales desde el plan Esencial de $100 (15,000 créditos) hasta un nivel Empresarial de $6,000. El consumo de créditos por segundo para los modelos actuales:
| Calidad | V6 (sin audio / con audio) | C1 (sin audio / con audio) |
|---|---|---|
| 360p | 5 / 7 créditos | 6 / 8 créditos |
| 540p | 7 / 9 créditos | 8 / 10 créditos |
| 720p | 9 / 12 créditos | 10 / 13 créditos |
| 1080p | 18 / 23 créditos | 19 / 24 créditos |
Atlas Cloud mide los mismos dos modelos en dólares por segundo, sin paquete ni membresía previa. Verificado en las páginas de modelos en vivo el 23 de julio de 2026, a precio de lista sin descuento activo:
| Calidad | V6 (sin audio / con audio) | C1 (sin audio / con audio) |
|---|---|---|
| 360p | $0.025 / $0.035 | $0.030 / $0.040 |
| 540p | $0.035 / $0.045 | $0.040 / $0.050 |
| 720p | $0.045 / $0.060 | $0.050 / $0.065 |
| 1080p | $0.090 / $0.115 | $0.095 / $0.120 |
Un clip hace concreta la comparación. Un clip V6 de 5 segundos a 720p con audio cuesta 60 créditos: eso es $0.60 a la tarifa del paquete de $10, o aproximadamente $0.40 a la tarifa de membresía Esencial después de comprometer $100 por el mes. Medido en Atlas Cloud, el clip idéntico es $0.30. El modelo C1 tiene un precio ligeramente más alto por segundo, $0.325 para ese mismo clip a través del playground de C1, que compra su ajuste de producción cinematográfica.
Los créditos aún tienen sentido para equipos que ya están dentro de la plataforma de PixVerse, especialmente en volúmenes de nivel Escala donde la tarifa efectiva disminuye. Para todos los demás, el precio en dólares por segundo es más fácil de pronosticar: el precio de un render es la duración multiplicada por la tarifa, legible antes de gastar.
La empresa desarrolladora de PixVerse AI detrás de la API
Una API es una apuesta por la empresa que la ejecuta, y vale la pena conocer a la empresa desarrolladora de PixVerse AI antes de construir. PixVerse está construido por AISphere (Aishi Technology), fundada en abril de 2023 en Pekín y ahora con sede en Singapur con aproximadamente 150 empleados. El fundador y CEO Wang Changhu dirigió el trabajo de visión del AI Lab de ByteDance de 2017 a 2021, lo que convierte a PixVerse en un rival directo de Seedance, construido por su antiguo empleador. El cofundador Jaden Xie proviene de Lighthouse Capital.
El panorama de financiación es inusualmente sólido para un taller independiente de modelos de video. El 13 de julio de 2026, la empresa cerró una extensión de la Serie C que eleva la ronda a $439 millones con una valoración superior a $2 mil millones, con la participación de Alibaba, según TechCrunch. Para un desarrollador, eso se traduce en pista: es poco probable que la API que integres este trimestre desaparezca el próximo año.
La otra cara de un laboratorio bien financiado es la velocidad de lanzamiento. Solo la línea de lanzamientos de 2026:
Tres lanzamientos de modelos en tres meses explican el retraso en la documentación que este artículo sigue señalando. Construye en consecuencia: fija tu cadena de modelo, lee las notas de la versión antes de cambiarla y vuelve a verificar la referencia del endpoint en lugar de asumir que los parámetros del trimestre pasado sobrevivieron.
Preguntas frecuentes
¿Dónde está la documentación oficial de la API de PixVerse?
En docs.platform.pixverse.ai, con la consola de desarrollador en platform.pixverse.ai. Cualquier cosa alojada en app.pixverse.ai es el producto de consumo, y las páginas de terceros de "documentación de la API de PixVerse" a menudo describen parámetros de la era v4. Los documentos también incluyen una página de texto consolidada lista para LLM que puedes alimentar a un asistente de codificación.
¿Cómo obtengo una clave de API de PixVerse?
Regístrate en la consola de la plataforma en platform.pixverse.ai, crea una clave y pásala en el encabezado API-KEY junto con un UUID Ai-trace-id único por solicitud. Las claves están vinculadas a los créditos de la plataforma, que se compran por separado de cualquier suscripción de la aplicación de consumo. En Atlas Cloud, el equivalente es una clave de consola pasada como un token Bearer estándar.
¿La API de PixVerse tiene un nivel gratuito?
Los documentos de precios de la plataforma solo muestran paquetes de créditos y membresías pagadas. Los créditos gratuitos diarios variables que PixVerse promociona pertenecen a la aplicación de consumo y no fluyen al libro de contabilidad de la API. Los puntos de entrada pagados más baratos son un paquete de créditos de $10 en la plataforma oficial o la generación medida desde $0.025 por segundo en Atlas Cloud.
¿Qué modelos puede ejecutar la API de PixVerse?
El endpoint de generación actual acepta ocho valores de modelo: v3.5, v4, v4.5, v5, v5.5, v5.6, v6 y c1. V6 y C1 son la generación actual, con clips de 1 a 15 segundos y audio nativo opcional. Los nombres antiguos aún funcionan pero cuestan más créditos con la misma configuración que V6. La generación V2 ya no está disponible de primera parte.
¿Cuánto cuesta la API de PixVerse AI por video?
Plataforma oficial: un clip V6 de 5 segundos a 720p con audio cuesta 60 créditos, aproximadamente $0.60 a la tarifa del paquete de $10. Atlas Cloud: el mismo clip cuesta $0.30 medido, en un rango por segundo de $0.025 a $0.115 según la resolución y el audio. C1 cuesta un poco más, $0.325 para ese clip. Precios verificados el 23 de julio de 2026.
Conclusión
La API de PixVerse está en mejor forma que su documentación. El servicio en sí es rápido, bien financiado y actual: ocho valores de modelo, clips de hasta 15 segundos, audio en la misma pasada y un flujo asíncrono que cualquier desarrollador junior puede conectar en una tarde. La documentación simplemente no ha seguido el ritmo del calendario de lanzamientos, por lo que las referencias de endpoints y las guías prácticas describen productos diferentes.
El método de trabajo es simple. Confía en la referencia del endpoint, programa usando el límite más estricto cuando las páginas discrepen y fija tu cadena de modelo. Luego elige tu forma de facturación: créditos en la plataforma oficial si tu equipo ya vive allí, o dólares por segundo desde $0.025 si quieres que el precio de cada render sea legible antes de enviarlo. El clip predeterminado de $0.30 en el playground es un lugar barato para descubrir de qué lado estás.
