[Image 1], [Image 2], etc., en su prompt, y luego realice el seguimiento de la tarea asíncrona mediante img_uuid.API de referencia HappyHorse 1.1
Genere video guiado por referencia a través de la API independiente de GoEnhance. Envíe de 1 a 9 URL de imágenes públicas, haga referencia a ellas como
Obtener clave de API
Cree una solicitud de referencia a video
Guíe el movimiento con 1 a 9 imágenes de referencia
Realice una solicitud POST a https://api.goenhance.ai/api/v1/videos/generations con model: happyhorse-1-1-ref. La matriz obligatoria image_urls acepta de 1 a 9 URL de imágenes públicas.
Controle la composición y la finalización
Defina el prompt, la relación de aspecto, la duración y la resolución, y luego conserve el img_uuid devuelto. Consulte GET /api/v1/jobs/detail o reciba notificaciones de cambio de estado en una URL HTTPS pública.
Valide cada campo antes de enviar una tarea de generación.
Capacidades de la API de referencia HappyHorse 1.1
Modo de entrada solo de referencia
Esta ruta requiere <code>image_urls</code> y no admite la generación de texto a video puro.
1 a 9 imágenes de referencia
Proporcione entre una y nueve URL de imágenes públicas en el orden utilizado por su prompt.
Referencias de prompt indexadas
Haga referencia a las entradas explícitamente como <code>[Image 1]</code>, <code>[Image 2]</code>, etc.
Siete relaciones de aspecto
Elija 16:9, 9:16, 3:4, 4:3, 4:5, 5:4 o 1:1. El valor predeterminado es 16:9.
Duración de 3 a 15 segundos
Establezca una duración entera de 3 a 15 segundos. El valor predeterminado documentado es 5 segundos.
720p o 1080p
Seleccione una salida de 720p o 1080p. El valor predeterminado documentado es 720p.
El precio es por segundo generado según la conversión documentada de $0.02 por token.
Precios de la API de referencia de HappyHorse 1.1
Precios de 720p
5.2 tokens por segundo generado, equivalente a $0.104 por segundo.
Precios de 1080p
7.2 tokens por segundo generado, equivalente a $0.144 por segundo.
Estime cada solicitud
Multiplique la tarifa seleccionada por segundo por la duración. Por ejemplo, 5 segundos a 720p utilizan 26 tokens.
Integre la API de HappyHorse en seis pasos
1
1. Crear una clave de API
Cree una clave de GoEnhance y envíela como token de portador (bearer token) en el encabezado de autorización.
2
2. Alojar imágenes de referencia
Proporcione de 1 a 9 URL de imágenes accesibles públicamente en el orden de matriz requerido.
3
3. Escribir un prompt indexado
Describa el movimiento y las relaciones mientras nombra cada entrada como
[Image N]. 4
4. Validar la configuración de salida
Elija una relación de aspecto compatible, una duración de 3 a 15 segundos y una resolución de 720p o 1080p.
5
5. Enviar y persistir el ID
Realice un POST de la tarea y guarde el
img_uuid devuelto antes de procesar los eventos de finalización. 6
6. Sondear o recibir devoluciones de llamada
Sondee el punto final de detalles del trabajo o gestione los cambios de estado en una URL de devolución de llamada HTTPS pública.
Cree flujos de trabajo de video repetibles en torno a entradas visuales aprobadas.
Casos de uso de la API de referencia de HappyHorse
Continuidad de personajes
Utilice referencias de personajes aprobadas para guiar la identidad y el estilo a lo largo de una toma generada.
Narrativa de producto
Combine referencias de producto, entorno y estado de ánimo en un concepto de video dirigido por un prompt.
Variantes de campaña
Parametrice conjuntos de referencia y prompts para variaciones creativas mientras mantiene un único gestor de tareas.
Desarrollo de guiones gráficos
Convierta tableros visuales y referencias de dirección artística en conceptos de movimiento cortos para su revisión.
Creatividad localizada
Intercambie referencias regionales aprobadas mientras preserva su flujo de trabajo de validación y finalización.
Previsualización
Explore las interacciones entre múltiples sujetos referenciados antes de comprometerse con la producción completa.
Respuestas a preguntas comunes sobre entradas, precios e integración asíncrona.