Tus usuarios ya saben qué es un clip corto. Lo que no tienen es una forma de hacer uno dentro de tu app sin saltar a otra pestaña y volver con un archivo. Con la API de Picasso IA, tu app envía una petición por generación, nombrando un modelo de video y sus entradas, y el clip terminado vuelve como un archivo que puedes mostrar, guardar y revisar. La petición es la parte fácil. Lo que de verdad cuesta es el producto que la rodea: la espera, los créditos, la moderación, el almacenamiento y los derechos.
Una función de video cambia para qué sirve tu producto. Una app de tarjetas que anima la tarjeta, un diario de viaje que convierte una foto en una postal en movimiento, una herramienta de juegos que crea una intro corta para un personaje, un panel de tienda que prepara el borrador de un clip de producto: en todos los casos el usuario se queda donde ya vive su trabajo, en lugar de exportar, convertir e importar.
La otra razón es la elección. El catálogo de Picasso IA tiene 502 modelos, 121 de ellos en la categoría de texto a video y otros 28 en edición de video. Para quien construye importa, porque ningún modelo de video es el mejor en todo. Uno maneja bien a una persona, otro sigue de cerca una instrucción de cámara, otro es la opción más barata para un borrador. La API está pensada para llegar al mismo catálogo que el toolkit y al mismo sistema de créditos, así que no atas tu función a las manías de un solo motor.
El planteamiento honesto: esto es una forma de ofrecer generación, no de garantizar resultados. Cada clip que crean tus usuarios es un modelo interpretando un prompt, y tu producto tiene que diseñarse alrededor de ese hecho, no a pesar de él.
Antes de cualquier arquitectura, anota las tres o cuatro cosas que una persona hace en tu función. La mayoría de las funciones de video se reducen al mismo conjunto pequeño de acciones, y nombrarlas pronto mantiene honesta la interfaz.
La primera es texto a video: el usuario describe una escena y un movimiento en una o dos frases y recibe un clip. La segunda es imagen a video: adjunta una imagen suya, como una foto de producto, un dibujo o un retrato de sí mismo, y pide que se mueva. La tercera es el reintento: el primer clip se acerca pero falla, así que cambia una palabra y genera de nuevo. La cuarta, si tu producto la necesita, es una edición posterior pequeña, como recortar, escalar o añadir sonido, que cubren otros modelos del catálogo. Para ver cómo funciona la segunda acción, convertir fotos en videos lo recorre en el toolkit.
Nada de esa lista exige que el usuario sepa qué modelo se ejecutó. Puedes ofrecer un selector o elegir por él.
Cinco preocupaciones deciden si una función de video se siente sólida o frustrante. Ninguna es un problema de programación y todas tienen una versión que el usuario ve. Esta tabla es la hoja de planificación: lo que vive el usuario y la decisión que te toca a ti.
| Preocupación | Lo que vive tu usuario | La decisión que es tuya |
|---|
| Tiempo de espera | Un clip no es instantáneo, así que la pantalla necesita un estado para eso | Mostrar progreso, dejar que se vayan y vuelvan, o avisarles |
| Créditos | Cada generación cuesta créditos que dependen del modelo y los ajustes | Trasladar el coste, asumirlo o limitar cuántos clips puede hacer una persona |
| Moderación | Algunos prompts o imágenes nunca deberían convertirse en clip | Filtrar entradas, revisar salidas y decidir qué hace una denuncia |
| Almacenamiento | El archivo devuelto tiene que vivir donde puedan encontrarlo otra vez | Dónde se guarda, por cuánto tiempo y quién puede borrarlo |
| Derechos | El clip puede mostrar un rostro, una voz o un diseño que es de alguien | Exigir que suban solo material propio o sujetos ficticios |
El tiempo de espera merece la mayor atención de diseño, porque es lo que el usuario siente. Generar lleva tiempo real y varía con el modelo y los ajustes, así que construye para un rango y no para una cifra. Quien puede seguir usando tu app mientras un clip se genera perdona una espera larga.
Los créditos son la otra cuestión silenciosa. El coste sale del modelo y de los ajustes elegidos, y la página de precios es donde viven los planes. Decide pronto si tus usuarios ven los créditos, porque cambia tu interfaz: una app que gasta tus créditos en su nombre necesita límites, y una que los traslada necesita un precio claro antes del clic.
Regla de diseño: trata el clip como un resultado que llega más tarde, no como una respuesta que esperas. Si tu pantalla solo funciona cuando la respuesta es rápida, fallará la primera vez que un modelo vaya lento.
Puedes ejecutar casi todo este ciclo hoy sin escribir nada, porque el toolkit corre el mismo catálogo que la API está pensada para exponer. Úsalo para decidir qué debe pedir tu función a los usuarios y luego replica la misma forma en tu app.
- Prueba el prompt en el toolkit. Abre el toolkit, elige un modelo de video como veo-3.1 o kling-v3-video y escribe el tipo exacto de prompt que escribirían tus usuarios, incluidos los malos.
- Crea una clave en tu cuenta. La API funciona con una clave que creas en tu cuenta. Trátala como una contraseña: guárdala en tu servidor, nunca dentro de una app que la gente descarga ni en una página que pueda inspeccionar.
- Envía una petición por clip. Tu servidor nombra el modelo y las entradas, un prompt y, en los modelos que animan una imagen, una imagen. Tu app avisa enseguida al usuario de que su clip se está creando.
- Espera y recoge el archivo. El resultado vuelve como un archivo que puedes descargar. Pásalo por tu paso de revisión y guárdalo donde el usuario pueda encontrarlo de nuevo.
- Muestra el clip y cuenta los créditos. Coloca el clip en la biblioteca del usuario, registra lo que costó la generación y compara los totales con el plan de tu cuenta.
Haz el paso uno con una docena de prompts reales antes del paso tres. Los prompts que escribe un desconocido son de donde salen tus decisiones de moderación.
No hace falta decidirse por un solo modelo para toda la función. Piensa en papeles, prueba algunos en el toolkit y elige por caso de uso. Son modelos que existen hoy en el catálogo, todos en la categoría de texto a video, que también incluye las variantes de imagen a video.
Para un resultado premium en un momento estelar, empieza con veo-3.1 de google o kling-v3-video de kwaivgi. Para clips cortos y juguetones, merecen una prueba seedance-2.0 de bytedance y hailuo-2.3 de minimax. wan-3 de alibaba y sora-2 de openai completan una primera comparación, y ltx-2.3-fast de lightricks es el nombre que conviene probar para ver cómo se comporta un modelo más ligero en borradores.
No lo leas como un ranking. Pasa los mismos tres prompts por cada uno, mira rostros, manos, movimiento y cuánto siguió el prompt, y anota qué modelo gana en cada trabajo. Si tu producto convierte imágenes fijas en clips, la página de videos de demostración de producto con IA muestra qué necesita una foto de producto para sobrevivir a la animación. Explora la lista completa en el catálogo antes de fijar tu selección.
Una API de generación te da clips. No te da un producto de video. Estos son los límites sobre los que planificar, para que ninguno llegue por sorpresa después del lanzamiento.
- Tiempo: cada clip tarda en generarse y el tiempo depende del modelo y los ajustes. Tu interfaz necesita un estado de espera, una forma de volver más tarde y un plan para una petición que falla.
- Coste: cada generación gasta créditos y los modelos más pesados gastan más. Una función sin límites puede quemar créditos más rápido de lo que esperas, así que decide topes antes de que lo haga el primer usuario.
- Variación: los modelos difieren, y el mismo prompt da resultados distintos en motores distintos, e incluso en intentos distintos. No puedes prometer un clip concreto, solo un intento.
- Revisión: las salidas pueden traer manos raras, texto derretido o un rostro que cambia. Alguien, o alguna regla, tiene que mirar los clips antes de que aparezcan donde los ve más gente.
- Derechos: el archivo que recibes no resuelve de quién es lo que muestra. Tus términos deben decir que los usuarios suben solo material propio o sujetos ficticios, nunca la imagen de una persona real sin su consentimiento.
Nada de esto va en contra de la función. Va a favor de acotarla: clips cortos, un estado de espera claro, créditos visibles y un paso de revisión. Una función pequeña que se comporta de forma predecible gana a una grande que sorprende a la gente.
¿Pueden mis usuarios generar video sin salir de mi app?
Ese es el propósito de la API de Picasso IA. Tu servidor envía una petición por clip, nombrando un modelo y sus entradas, y el resultado vuelve como un archivo que puedes descargar y mostrar en tus propias pantallas. Tus usuarios nunca ven otro sitio. Lo que sí notarán es la espera, porque un clip tarda en generarse, así que la experiencia depende de un buen estado de progreso más que de cualquier otra cosa que construyas.
¿Necesito una clave de API y cómo debo tratarla?
Sí. El acceso funciona con una clave que creas en tu cuenta, y debe tratarse como una contraseña. Guárdala en tu servidor, cárgala desde un almacén de secretos o una variable de entorno y nunca la pongas en una app móvil, en un paquete del navegador ni en un repositorio público. Si crees que se filtró, sustitúyela desde tu cuenta y actualiza tu servidor. Tus usuarios nunca necesitan verla.
¿Qué modelos puedo ofrecer en una función de video?
El catálogo tiene 121 modelos de texto a video y 28 de edición de video, de 502 en total, y el toolkit los ejecuta todos hoy. Entre los nombres que conviene probar primero están veo-3.1, kling-v3-video, seedance-2.0, hailuo-2.3, wan-3 y sora-2. Mira la página de cada modelo para saber qué acepta, porque algunos solo toman un prompt y otros pueden partir de una imagen. Pasa tus propios prompts por el toolkit antes de elegir.
¿Cuánto esperarán mis usuarios por un clip?
Depende del modelo, la duración y los ajustes, así que esta página no da ninguna cifra. Planifica para un rango: algunos clips volverán rápido y otros tardarán claramente más. El diseño seguro es confirmar la petición al instante, mostrar que hay trabajo en curso, dejar que la persona siga usando tu app y avisarle cuando el archivo esté listo. Prueba los modelos que elijas en el toolkit para sentir las esperas reales.
¿Cómo funcionan los créditos cuando mis usuarios generan clips?
Generar cuesta créditos y la cantidad depende del modelo y de los ajustes elegidos. La API está pensada para usar el mismo sistema de créditos que el toolkit, así que lo que ves allí es lo que debes esperar. Los planes y sus asignaciones están en la página de precios, y las cuentas nuevas reciben créditos gratis para probar. Tú decides si asumes el coste, lo trasladas a tus usuarios o limitas cuántos clips puede hacer cada persona.
¿Qué debería moderar en una función de video?
En dos lugares: lo que entra y lo que sale. En las entradas, decide qué prompts e imágenes subidas rechazas, como imágenes de personas reales que no han aceptado aparecer. En las salidas, revisa los clips antes de compartirlos públicamente, porque los modelos pueden producir resultados raros o no deseados. Da a los usuarios una forma de denunciar un clip y decide qué pasa después. Tus propios términos de uso deben decir todo esto con claridad.
¿Dónde debería guardar los clips generados?
El resultado vuelve como un archivo que puedes descargar, así que conservarlo depende de ti. Guárdalo en un almacenamiento que controles, vinculado al usuario que lo pidió, y decide cuánto tiempo se queda y quién puede borrarlo. No cuentes con que el archivo devuelto siga disponible para siempre. Si los clips pueden compartirse, planifica las reglas de acceso desde el principio.
¿De quién son los clips que generan mis usuarios?
Comprueba dos cosas. Primero, los derechos de la entrada: un usuario que sube la foto de su propio producto está en una posición distinta a la de quien sube la obra de otra persona, y el generador no cambia de quién es lo que muestra una imagen. Segundo, los términos de tu plan para las salidas. Pon tus propias reglas ante los usuarios y haz que una persona cualificada las revise si los clips se van a vender o publicar con fines comerciales.
¿Pueden los usuarios animar fotos de sí mismos o de otras personas?
Solo de sí mismos, de alguien que haya aceptado claramente o de un personaje ficticio. Nunca de una persona real identificable sin su consentimiento, y nunca la foto de un menor subida por otra persona. Incorpóralo a tu pantalla de subida con una línea breve y clara, y a tus términos. Una regla clara gana a un filtro ingenioso.
¿Qué pasa si un clip sale mal o una petición falla?
Planifica ambos casos. Los clips fallidos son normales: deja que los usuarios editen el prompt y lo intenten de nuevo, y muestra el coste en créditos de un reintento antes de que pulsen el botón. Las peticiones que fallan necesitan un mensaje claro y una forma de reintentar. Si algo parece roto por tu parte o tienes una duda sobre tu cuenta, soporte es la vía directa a una persona.
Una buena forma de empezar es probar los clips que te pedirían tus usuarios. Abre el toolkit, pasa unos cuantos prompts reales por dos o tres modelos de video y anota qué tiene que prometer tu función.