Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
prompt | Sí | Describe the picture and the action you want. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 720p · 1080p · 2k · 4k · Por defecto: 720p |
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · Por defecto: 16:9 |
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. ≥ 5 · ≤ 20 · Por defecto: 5 |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
| resolution 720p | 13,5 | 0,14 US$ |
| resolution 1080p | 19,5 | 0,20 US$ |
| resolution 2K | 28,5 | 0,29 US$ |
| resolution 4K | 45 | 0,45 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 68 créditos por un clip de 5 segundos (0,68 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de LTX 2.5 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model lightricks/ltx-2.5/text-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "lightricks/ltx-2.5/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de LTX 2.5
¿Cuánto cuesta la API de LTX 2.5?
LTX 2.5 cuesta desde 68 créditos (0,68 US$) por un clip de 5 segundos con Crear video, su tarea más barata. Precios por opción: 720p 13,5 créditos por segundo, 1080p 19,5 créditos por segundo, 2K 28,5 créditos por segundo, 4K 45 créditos por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de LTX 2.5 en la API?
Pon lightricks/ltx-2.5/text-to-video para Crear video; lightricks/ltx-2.5/image-to-video para Imagen a video en el campo model de POST /jobs/createTask.
¿Qué tan largo puede ser un clip de LTX 2.5?
De cinco a veinte segundos completos en una sola solicitud, en ambos endpoints. No hay tarea de extensión, así que la duración se decide al generar y no encadenando clips.
¿Qué resoluciones admite LTX 2.5?
720p, 1080p, 2K y 4K, todas desde la misma forma de solicitud. 720p es el valor por defecto. La puesta en escena ya se juzga en 720p; los niveles altos compran textura, tejido de tela y detalle especular.
¿LTX 2.5 genera audio?
Sí. Los clips vuelven con una pista de audio generada aunque ninguno de los dos endpoints tenga campo de audio, así que no hay forma de desactivarla. Describe el sonido que quieres en el prompt y silencia o reemplaza la pista en la edición cuando el clip vaya bajo tu propia mezcla.
¿Qué proporciones hay disponibles?
Solo 16:9 y 9:16, en text-to-video. El image-to-video no tiene campo aspect_ratio en absoluto: el cuadro de apertura define la forma. Los entregables cuadrados y en 4:3 no están disponibles en esta familia.
¿Puedo mandar solo un cuadro de cierre?
No. last_image_url solo es válido junto a image_url. Fija dónde aterriza el plano; el movimiento entre los dos cuadros se sigue generando y puede irse lejos en un clip largo.
¿Qué límites tiene la API de LTX 2.5?
Duración del clip: 5–20 s; Resoluciones: 720p · 1080p · 2K · 4K; Relaciones de aspecto: 16:9 · 9:16. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar LTX 2.5 sin escribir código?
Sí. El Playground ejecuta LTX 2.5 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de LTX
MiniMax H3 cubre más formatos y añade fotos de referencia, pero se queda en 15 segundos. LTX 2.5 es la opción para tomas de 20 segundos y 4K nativo.
- API de LTX 2.5Tomas largas de 20 segundos hasta 4K, con banda sonoraDesde 68 créditos por un clip de 5 segundos
- API de LTX-2.3 LoRAClips LTX-2.3 con sonido estéreo y tus propios LoRADesde 18 créditos por un clip de 5 segundos
- API de LTX-2 19BClips de 20 segundos con voces, música y efectosDesde 11 créditos por un clip de 5 segundos
- API de LTX-2 19B LoRAClips LTX-2 con sonido y tus propios estilos LoRADesde 14 créditos por un clip de 5 segundos

