img_uuid devuelto y luego realice sondeos o reciba devoluciones de llamada HTTPS para obtener el resultado.API de HappyHorse 1.1 para generación de video
Acceda a la API de HappyHorse 1.1 a través de la API abierta e independiente de GoEnhance para texto a video, imagen a video con fotograma inicial o un flujo de trabajo de imagen de referencia independiente. Envíe una tarea asíncrona, guarde el
Crear una clave de API
Elija el modo de API de HappyHorse correcto
Texto a video
Envíe model: happyhorse-1-1 con un prompt obligatorio y sin image_url. Seleccione una relación de aspecto, duración y resolución documentadas para el video generado.
Imagen a video con fotograma inicial
Añada image_url para animar un fotograma inicial. La imagen debe ser JPEG, PNG o WEBP, de al menos 300px, menos de 10MB y dentro del rango de relación de aspecto documentado de 1:2.5 a 2.5:1.
Video con imagen de referencia
Utilice model: happyhorse-1-1-ref con 1 a 9 URL en image_urls. Haga referencia a cada fuente en el prompt como [Image 1], [Image 2], y así sucesivamente.
Valide el modo de solicitud seleccionado antes de enviar trabajo a su cola de producción.
Capacidades y límites de la API de HappyHorse 1.1
Dos modos de entrada estándar
Utilice un prompt solo para texto a video o añada una <code>image_url</code> para imagen a video con fotograma inicial.
Modelo de referencia múltiple independiente
Utilice <code>happyhorse-1-1-ref</code> con 1 a 9 URL de imagen de referencia obligatorias; no admite texto a video puro.
Duración de 3 a 15 segundos
Establezca <code>duration</code> en un número entero de 3 a 15 segundos. El valor predeterminado documentado es 5 segundos.
Salida de 720p o 1080p
Elija <code>720p</code> o <code>1080p</code>. El valor predeterminado documentado es <code>720p</code>.
Relaciones de aspecto vertical, cuadrada y horizontal
La ruta estándar admite 16:9, 9:16, 1:1, 4:3 y 3:4. El modo de referencia también incluye 4:5 y 5:4.
Sondeo y devoluciones de llamada
Conserve el <code>img_uuid</code>, realice sondeos en el endpoint de detalles del trabajo o proporcione una URL de devolución de llamada HTTPS pública para actualizaciones de estado.
GoEnhance documenta los precios por segundo en $0.02 por token y actualmente etiqueta estas tarifas como una oferta por tiempo limitado.
Precios de la API de HappyHorse 1.1
720p: $0.104 por segundo
La generación a 720p utiliza 5.2 tokens por segundo. Una solicitud de 5 segundos utiliza 26 tokens, o $0.52 según la conversión documentada.
1080p: $0.144 por segundo
La generación en 1080p utiliza 7,2 tokens por segundo, lo que equivale a $0.144 por segundo generado.
Estimación por duración
Multiplique la tarifa por segundo seleccionada por la duración solicitada de 3 a 15 segundos. Consulte la referencia de la API en vivo antes de realizar lotes de producción, ya que los precios promocionales pueden cambiar.
Integre la API de HappyHorse 1.1
1
1. Cree y proteja una clave de API
Cree una clave de GoEnhance y envíela como autorización de portador (bearer) desde un código de servidor confiable.
2
2. Seleccione el modelo
Elija
happyhorse-1-1 para la generación solo a partir de texto o del primer fotograma, o happyhorse-1-1-ref para 1 a 9 imágenes de referencia. 3
3. Construya y valide la carga útil
Proporcione el prompt requerido, luego valide los campos de imagen, duración, resolución, relación de aspecto y URL de devolución de llamada para el modo elegido.
4
4. Envíe la tarea de video
Realice una solicitud POST a
https://api.goenhance.ai/api/v1/videos/generations y almacene el img_uuid devuelto. 5
5. Seguimiento del estado
Consulte
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... o reciba cambios de estado en una devolución de llamada HTTPS pública. 6
6. Maneje el resultado final
Procese el éxito y el error de forma idempotente, verifique el activo devuelto y evite el trabajo duplicado en procesos posteriores cuando las consultas y las devoluciones de llamada se superpongan.
Conecte las solicitudes de generación estructuradas con los flujos de trabajo de revisión, almacenamiento y entrega.
Casos de uso para desarrolladores de la API de HappyHorse
Variantes de video para campañas
Genere conceptos de movimiento cortos a partir de prompts estructurados para revisión creativa y edición posterior.
Movimiento de productos y marcas
Anime un primer fotograma aprobado mientras su backend controla la duración, la resolución y el manejo de la finalización.
Estudios de interacción de personajes
Utilice el modelo de referencia para describir cómo deben aparecer juntos en una escena los sujetos de las imágenes fuente aprobadas.
Previsualización de guiones gráficos
Convierta las descripciones de las tomas en clips revisables antes de comprometerse con un flujo de trabajo de producción mayor.
Canalizaciones creativas localizadas
Parametrice los prompts para variantes regionales mientras mantiene la consistencia en el envío y la supervisión de tareas.
Colas de activos automatizadas
Conecte la generación, la persistencia del estado del trabajo, las devoluciones de llamada, el almacenamiento y la aprobación humana en un servicio de backend.
Respuestas sobre precios, modos de solicitud, límites de entrada y gestión de tareas asíncronas.