HappyHorse 1.0 Image-to-Video

Autorizaciones

Authorization

string

header

requerido

##Todas las interfaces requieren autenticacion mediante Bearer Token##

Obtener API Key:

Visite la Pagina de gestion de API Key para obtener su API Key

Agregar en el encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:happyhorse-1.0-image-to-video

requerido

Nombre del modelo de generacion de video

Opciones disponibles:

happyhorse-1.0-image-to-video

Ejemplo:

"happyhorse-1.0-image-to-video"

image_urls

string<uri>[]

requerido

URL de la imagen de primer fotograma, obligatorio (se toma el primer elemento del array como primer fotograma)

Requisitos de imagen:

Formatos admitidos: JPEG, JPG, PNG, WEBP
Resolucion: ancho y alto ≥ 300 px
Relacion de aspecto: 1:2.5 ~ 2.5:1
Tamaño del archivo: ≤ 10MB
Las URLs de imagen deben ser accesibles publicamente (HTTP o HTTPS); no se admiten enlaces OSS privados, de intranet o autenticados

Required array length: 1 element

Ejemplo:

["https://cdn.example.com/cat.png"]

prompt

string

Indicacion de texto, opcional (cuando se omite, el primer fotograma guia la interpretacion libre)

Limites de longitud:

Chino: hasta 2500 caracteres
No chino: hasta 5000 caracteres
El contenido excedente se trunca automaticamente

Ejemplo:

"Make the cat in the picture run on the grass"

quality

enum<string>

predeterminado:720p

Nivel de resolucion del video, valor predeterminado 720p

Opciones:

720p: claridad estandar, este es el valor predeterminado
1080p: claridad HD

Nota de facturacion: El nivel de resolucion afecta directamente la facturacion

Opciones disponibles:

720p,

1080p

Ejemplo:

"720p"

duration

integer

predeterminado:5

Duracion del video (segundos), valor predeterminado 5 segundos

Rango:

Entero 3 ~ 15
La duracion afecta directamente la facturacion

Rango requerido: 3 <= x <= 15

Ejemplo:

5

seed

integer

Semilla aleatoria, valor predeterminado aleatorio

Detalles:

Rango: 1 ~ 2147483647
Una semilla fija reduce las variaciones inducidas por parametros al iterar sobre prompts y mejora la reproducibilidad

Rango requerido: 1 <= x <= 2147483647

Ejemplo:

42

callback_url

string<uri>

Direccion de callback HTTPS despues de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa, falla o se cancela
Se envia despues de confirmar la facturacion

Restricciones de seguridad:

Solo admite protocolo HTTPS
Prohibido el callback a direcciones IP privadas (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Maximo 3 reintentos despues del fallo (respectivamente 1/2/4 segundos despues del fallo)
El formato del cuerpo de la respuesta de callback coincide con el formato de respuesta de la API de consulta de tarea
Un codigo de estado 2xx se considera exitoso; otros codigos activan reintentos

Ejemplo:

"https://your-domain.com/webhooks/video-task-completed"

Respuesta

Tarea de generacion de video creada exitosamente

created

integer

Marca de tiempo de creacion de la tarea

Ejemplo:

1761313744

string

ID de la tarea

Ejemplo:

"task-unified-1761313744-h1i2vcd9"

model

string

Nombre del modelo realmente utilizado

Ejemplo:

"happyhorse-1.0-image-to-video"

object

enum<string>

Tipo especifico de la tarea

Opciones disponibles:

video.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed,

cancelled

Ejemplo:

"pending"

task_info

object

Informacion detallada de la tarea de video

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"video"

usage

object

Informacion de uso y facturacion

Show child attributes