Por capacidad
Videos
Los videos siempre se ejecutan como tarea: envía y luego consulta o recibe un callback. Los clips más largos y nítidos cuestan más.
#1. Elige un modelo
#3. Obtén el resultado
La llamada de envío responde de inmediato con un task_id. Consulta la tarea cada pocos segundos hasta que status sea completed, o pasa webhook_url y te llamaremos cuando termine.
GET https://www.aisplice.store/v1/videos/{task_id}
GET https://www.aisplice.store/v1/videos/{task_id}/content
La duración y la resolución determinan el nivel de precio. Una tarea en curso se puede cancelar; consulta la referencia de la API.
Solo se cobra si tiene éxito
Valores de estado y consulta periódica →Recibe un callback en lugar de consultar →
#Si algo sale mal
- 400 con un nombre de campo: este modelo no acepta esa opción; usa los valores indicados en el paso 2.
- Imagen o video de referencia rechazado: debe ser una URL pública que el modelo pueda descargar.
- Contenido rechazado por el modelo: reformula el prompt; las solicitudes rechazadas no se cobran.
- 402: el saldo no cubre esta solicitud; recarga en Billetera y reintenta.
- 429: reduce el ritmo y reintenta después de los segundos indicados en Retry-After.
- 503 model_not_found: el nombre del modelo es incorrecto o el modelo está fuera de línea; elige uno del paso 1.
#Primer y último fotograma, imágenes y videos de referencia
Los modelos que los aceptan muestran los campos en el paso 2: primer fotograma, último fotograma, imágenes de referencia o un video de referencia. Pasa URL públicas; sube primero los archivos locales.
Integrarlo en tu productoQué opciones mostrar primero a tus usuarios y cuáles dejar para más adelante.
Qué opciones mostrar primero a tus usuariosEmpieza con el prompt y un ajuste de precio; añade el resto cuando el flujo básico funcione.+
Intención creativa
Los campos como prompt van en la UI porque el usuario entiende directamente el resultado que cambian.
Multiplicador de costo
Los campos como duración, resolución, tamaño y cantidad solo deben introducirse cuando el precio ya se pueda explicar.
Cambio de modo
Los campos como imagen, máscara o ID de continuación cambian el propio flujo de trabajo y solo deben aparecer en modos dedicados.
Infraestructura del sistema
Los campos como webhook_secret son para integradores, no para creadores habituales, así que déjalos fuera de la UI predeterminada.
prompt- Cuándo mostrarlo
- Siempre. Define la escena o la dirección del movimiento.
- Valor predeterminado recomendado
- Obligatorio en la UI.
- Por qué importa
- Sin él, los usuarios no pueden orientar la intención del clip.
image / images- Cuándo mostrarlo
- Muéstralo solo en productos basados en referencias o de imagen a video.
- Valor predeterminado recomendado
- Ocúltalo en los flujos solo con prompt.
- Por qué importa
- Cambia el modo de creación y debe ser una decisión de producto deliberada.
duration- Cuándo mostrarlo
- Muéstralo cuando el flujo asíncrono básico sea estable y el precio esté visible.
- Valor predeterminado recomendado
- Empieza por la duración más corta admitida.
- Por qué importa
- Es uno de los mayores multiplicadores de costo y latencia en la generación de video.
resolution- Cuándo mostrarlo
- Muéstralo cuando los clientes comparen explícitamente salidas en 720p, 1080p o 4K.
- Valor predeterminado recomendado
- Elige una resolución recomendada en el servidor.
- Por qué importa
- Una resolución mayor aumenta el costo, el tiempo en cola y la sensibilidad a fallos.
webhook_url / webhook_secret- Cuándo mostrarlo
- Muéstralo solo a integradores de backend, no a usuarios finales normales.
- Valor predeterminado recomendado
- En productos con UI, prefiere la consulta periódica.
- Por qué importa
- Resuelven la integración de sistemas, no la creatividad del usuario final, así que deben quedar fuera de los controles de cara al consumidor.
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content
Phase 2
- one quality or resolution selector
- clear pricing hint
Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuningMantén una única fuente de verdad para los resultados
¿Sigues con el problema?
Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.