Documentación de la API HappyHorse

Guía completa para integrar la API de generación de vídeo HappyHorse 1.0 en tus aplicaciones.

API v1.0 Base URL: https://happyhorse.app

Inicio rápido

bash

curl -X POST 'https://happyhorse.app/api/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0/video",
    "prompt": "A cinematic shot of mountains at sunrise",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Autenticación

Todas las solicitudes requieren un token Bearer en el encabezado Authorization.

Obtener tu clave API: Puedes obtener tu clave en la página API Keys del panel. → Obtener tu clave API

http

Authorization: Bearer YOUR_API_KEY

Modelos disponibles

HappyHorse 1.0

Generación de vídeo con IA de alta calidad con HappyHorse

Tipo	Descripción	Duración	Créditos
`pro (text-to-video)`	Texto a vídeo calidad Pro	3-15s	54/s (no audio) · 80/s (with audio)
`pro (image-to-video)`	Imagen a vídeo calidad Pro	3-15s	54/s (no audio) · 80/s (with audio)
`std (text-to-video)`	Texto a vídeo calidad estándar	3-15s	40/s (no audio) · 60/s (with audio)
`std (image-to-video)`	Imagen a vídeo calidad estándar	3-15s	40/s (no audio) · 60/s (with audio)

Endpoints de la API

Crea una tarea de generación de vídeo. El campo model debe ser 'happyhorse-1.0/video'.

Cuerpo de la solicitud

Parámetros del cuerpoJSON

model:string

Nombre del modelo; debe ser 'happyhorse-1.0/video'

prompt:optional string

Descripción en texto del vídeo (máx. 2500 caracteres). No es obligatorio si multi_shots es true.

mode:optional string

Modo de calidad: 'pro' o 'std' (predeterminado: std) Defaults to std.

duration:optional number

Duración en segundos (3–15, predeterminado: 5) Defaults to 5.

aspect_ratio:optional string

Relación de aspecto de salida (16:9, 9:16, 1:1) Defaults to 16:9.

image_urls:optional string[]

Array de URLs de imagen para imagen a vídeo

sound:optional boolean

Activar audio nativo (predeterminado: true) Defaults to true.

cfg_scale:optional number

Adherencia al prompt (0-1, predeterminado: 0.5). Valores más altos siguen el prompt con más fidelidad. Defaults to 0.5.

multi_shots:optional boolean

Modo multi-plano con varios prompts Defaults to false.

multi_prompt:optional array

Array de objetos 'prompt, duration' para multi-plano

happyhorse_elements:optional array

Array de objetos de elemento. En el prompt, escribe @ seguido del valor de name (p. ej. name 'element_dog' → @element_dog). Cada elemento: name, description, element_input_urls (2-4 URLs de imagen). Max 3 por tarea.

Texto a vídeo

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "A majestic eagle soaring through clouds at sunset",
  "mode": "pro",
  "duration": 5,
  "aspect_ratio": "16:9",
  "sound": true
}

Imagen a vídeo

json

{
  "model": "happyhorse-1.0/video",
  "prompt": "The character slowly turns and smiles",
  "mode": "pro",
  "image_urls": ["https://example.com/my-image.jpg"],
  "duration": 5
}

Vídeo multi-plano

json

{
  "model": "happyhorse-1.0/video",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    { "prompt": "A woman walks into a coffee shop", "duration": 3 },
    { "prompt": "She orders a latte and sits by the window", "duration": 4 },
    { "prompt": "She looks outside and smiles", "duration": 3 }
  ],
  "aspect_ratio": "16:9"
}

Respuestas

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "IN_PROGRESS"
  }
}

Comprueba el estado con el task_id devuelto por el endpoint generate.

Parámetros de consulta

task_id:string

ID único devuelto por generate (prefijo n92)

Ejemplo de solicitud

bash

curl -X GET 'https://happyhorse.app/api/status?task_id=n92abc123hh10' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Consejo: El campo response contiene el array resultUrls. Usa data.response.resultUrls[0] para la URL del vídeo.

javascript

// Extract video URL from response
const videoUrl = data.response.resultUrls[0];

Respuestas

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n92abc123hh10",
    "status": "SUCCESS",
    "consumed_credits": 400,
    "created_at": "2026-04-08T10:30:00Z",
    "type": "text-to-video",
    "request": {
      "model": "happyhorse-1.0/video",
      "prompt": "A majestic eagle soaring through clouds at sunset",
      "mode": "pro",
      "duration": 5,
      "aspect_ratio": "16:9"
    },
    "response": {
      "resultUrls": [
        "https://cdn.example.com/videos/abc123.mp4"
      ]
    },
    "error_message": null
  }
}

Zona de pruebas API

Prueba la API en el navegador. Sustituye YOUR_API_KEY por tu clave real.

Zona de pruebas APIPOST

URL base

Endpoint

Cabeceras

Cuerpo de la solicitud

Códigos de error

Estado HTTP	Código	Descripción
400 Solicitud incorrecta	INVALID_PROMPT	El prompt no es válido o está vacío
400 Solicitud incorrecta	INVALID_DURATION	Duración fuera del rango admitido (3–15 s)
400 Solicitud incorrecta	INVALID_MODEL	El modelo debe ser 'happyhorse-1.0/video'
401 No autorizado	INVALID_API_KEY	Falta la clave API o no es válida
402 Pago requerido	INSUFFICIENT_CREDITS	Créditos insuficientes para esta operación
429 Demasiadas solicitudes	RATE_LIMITED	Demasiadas solicitudes; reduce la frecuencia
500 Error interno del servidor	INTERNAL_ERROR	Error del servidor; inténtalo más tarde