Acceso a la API de Happyhorse-1.0
Pago por uso · Sin suscripción · Úsalo en tu propia app
La API REST de Happyhorse-1.0 está en camino. Aunque el acceso directo a la API de Happyhorse está en vista previa privada, ya puedes generar vídeos desde la web — mismo modelo, misma calidad; paga solo por lo que uses.
Usa Happyhorse-1.0 Online — Sin clave de API
El sistema de claves de API de happyhorse está en desarrollo, pero el modelo ya está disponible hoy. Compra créditos, genera vídeo en 4K en el sitio y descárgalo — con licencia comercial completa incluida. Cuando se lance la API REST, tus créditos se trasladarán automáticamente.
Comprar créditos
Pago único, sin suscripción. Los créditos se comparten entre la app web, las futuras llamadas a la API de happyhorse y el nodo de ComfyUI.
Generar vídeo
Introduce tu prompt en el Laboratorio Happyhorse-1.0. El mismo modelo que impulsará la API REST — arquitectura daVinci-MagiHuman, 4K nativo.
Descargar y publicar
Salida en MP4 con propiedad IP comercial al 100%. Cuando el endpoint de la API de happyhorse esté disponible, introduce tu clave y automatiza el mismo flujo de trabajo.
Cómo funciona la API
La API REST Happyhorse-1.0 sigue un modelo asíncrono sencillo de solicitud y sondeo. Autentícate con tu clave de API de happyhorse, envía un trabajo y recupera el resultado cuando esté listo. A continuación se muestra una vista previa de la integración con la API happyhorse-1.0.
Autenticación
Incluye tu clave de API de happyhorse en la cabecera Authorization. Las claves tienen alcance por espacio de trabajo y están limitadas por tasa según el plan.
Enviar un trabajo
Envía (POST) tu prompt y parámetros al endpoint /v1/generate. El endpoint de la API de happy horse devuelve un job_id de inmediato.
Sondear el estado
Haz un GET a /v1/jobs/{job_id} para comprobar el progreso. Cuando el estado sea completed, la respuesta incluye una URL firmada del vídeo válida durante 24 horas.
Descargar y usar
Descarga el MP4 resultante o reprodúcelo directamente en streaming. Los créditos solo se descuentan si la generación se completa con éxito; los trabajos fallidos nunca se cobran.
curl — Enviar un trabajo de generación de vídeo
curl -X POST https://api.happyhorselab.net/v1/generate \
-H "Authorization: Bearer hh_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A lone astronaut walks across a red desert at golden hour, cinematic 4K",
"resolution": "4K",
"duration": 8,
"motion_strength": 0.7,
"fps": 24
}'Python — Ejemplo completo de integración
import requests
import time
API_KEY = "hh_xxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://api.happyhorselab.net/v1"
# Submit generation job
response = requests.post(
f"{BASE_URL}/generate",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"prompt": "A lone astronaut walks across a red desert at golden hour",
"resolution": "4K",
"duration": 8,
"motion_strength": 0.7,
"fps": 24,
},
)
job_id = response.json()["job_id"]
# Poll until complete
while True:
status = requests.get(
f"{BASE_URL}/jobs/{job_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
).json()
if status["status"] == "completed":
print("Video URL:", status["output_url"])
break
elif status["status"] == "failed":
print("Generation failed:", status["error"])
break
time.sleep(5)Precios y créditos
El acceso a la API de Happyhorse funciona con el mismo sistema de créditos que el sitio: sin suscripción independiente ni licencias por usuario. Los créditos que compres hoy sirven en la aplicación web y se trasladarán al modelo de pago por uso de la API de Happyhorse cuando se lance.
Estándar
Desde ~0,10 $ / vídeo
1080p, hasta 8 s, cola estándar. Ideal para prototipar y evaluar la API de vídeo con IA de Happy Horse.
Pro
Desde ~0,25 $ / vídeo
4K nativo, hasta 16 s, cola prioritaria. Diseñado para cargas de trabajo de producción: el modelo de pago por uso de la API de Happyhorse a escala.
Enterprise
Precios personalizados
Descuentos por volumen, garantías de SLA, endpoints dedicados y gestión de claves de la API de Happyhorse entre equipos.
Los créditos comprados en el sitio son totalmente intercambiables con los futuros créditos de la API. No hay un nivel de precios independiente para la API de Happyhorse: solo pagas por lo que generas.
Los créditos no caducan mientras tu cuenta se mantenga activa.
Endpoints de la API (Vista previa)
La API REST de Happyhorse-1.0 expone un conjunto acotado de endpoints para la generación de vídeo y la gestión de tareas. La documentación completa de la API de happyhorse-1.0 se publicará en el lanzamiento.
/v1/generateEnvía una tarea de generación de texto a vídeo o de imagen a vídeo. Devuelve un job_id para consultar el estado.
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | required | Descripción en texto del vídeo. |
| resolution | string | optional | "1080p" (predeterminado) o "4K". 4K requiere créditos Pro. |
| duration | integer | optional | Duración del vídeo en segundos. Rango: 2–16. Predeterminado: 8. |
| motion_strength | float | optional | Intensidad de movimiento 0.0–1.0. Predeterminado: 0.6. |
| fps | integer | optional | Fotogramas por segundo: 24 o 30. Predeterminado: 24. |
| seed | integer | optional | Semilla para la reproducibilidad. Omitir para aleatorio. |
/v1/jobs/{job_id}Consulta el estado de una tarea de generación. Devuelve el estado, el progreso y output_url cuando se completa.
/v1/creditsComprueba el saldo restante de créditos de la API de happyhorse y el historial de uso.
/v1/modelsLista los modelos disponibles y sus rangos de parámetros. Actualmente expone happyhorse-1.0.
Respuesta de ejemplo — Tarea completada
{
"job_id": "job_01HZ9X3K7VQWPN8S4TYJB6MDE",
"status": "completed",
"model": "happyhorse-1.0",
"created_at": "2025-06-01T14:22:10Z",
"completed_at": "2025-06-01T14:23:48Z",
"credits_used": 25,
"output_url": "https://cdn.happyhorselab.net/out/job_01HZ9X3K7VQWPN8S4TYJB6MDE.mp4",
"output_url_expires_at": "2025-06-02T14:23:48Z",
"metadata": {
"resolution": "4K",
"duration": 8,
"fps": 24,
"motion_strength": 0.7
}
}Preguntas frecuentes
Preguntas habituales sobre el acceso a la API de Happyhorse, los créditos y la integración.
¿Cómo consigo una clave de API de Happyhorse?
El sistema de claves de la API de Happyhorse está en vista previa privada. Mientras tanto, usa la aplicación web en happyhorselab.net: mismo modelo, misma calidad. Compra créditos en la página de precios y empieza a generar al instante. Las claves de API estarán disponibles en el panel cuando se lance el acceso directo.
¿La API Happyhorse-1.0 es compatible con ComfyUI?
Sí. El nodo personalizado oficial de Happyhorse para ComfyUI utiliza la misma API REST por debajo. Los créditos comprados para la aplicación web son intercambiables con la integración de ComfyUI. Consulta nuestra guía /comfyui para ver los detalles de configuración.
¿Cuáles son los límites de tasa?
Los límites de tasa dependerán de tu plan de créditos. El acceso estándar empezará en 10 trabajos simultáneos y 500 solicitudes por minuto. Los planes Enterprise ofrecen límites personalizados, endpoints dedicados y garantías de SLA; contáctanos para conocer los precios de happyhorse api para empresas.
¿Está disponible el acceso a la API para empresas o de marca blanca?
Sí. Los clientes Enterprise pueden solicitar endpoints de inferencia dedicados, paquetes de créditos por volumen, SLA personalizados y ajuste fino privado del modelo. Ponte en contacto a través de la página de precios y te responderemos con un plan a medida.
¿Caducan los créditos de la API de Happyhorse?
Los créditos comprados en happyhorselab.net no caducan mientras tu cuenta siga activa (al menos un inicio de sesión cada 365 días). La misma política de créditos de la API de Happyhorse se aplica tanto si los usas desde la aplicación web como desde la API o el nodo de ComfyUI.
¿Qué lenguajes de programación admite la API de Happyhorse?
La API REST de Happyhorse-1.0 es una API HTTP estándar: funciona con cualquier lenguaje: Python, Node.js, Go, Ruby, PHP, Java, Rust y más. Se prevén SDK oficiales para Python y TypeScript para el lanzamiento. Hasta entonces, usa cualquier cliente HTTP con tu clave de API de Happyhorse en el encabezado Authorization.
Crea con el modelo de vídeo nº 1 — Desde hoy
No esperes a la API. Usa Happyhorse-1.0 online ya, paga por crédito y tu saldo se transferirá automáticamente cuando se lance la API REST.
