happyhorse-1.1-i2v API

Utilice el ID de modelo exacto happyhorse-1.1-i2v. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestrahappyhorse-1.1-i2vPOST /v1/videos5.2s

Parámetros: duration=5resolution=1080pratio=16:9Imagen de entrada

Prompt: One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.

Solicitud que produjo este ejemplo, con la URL del medio de entrada reemplazada

{
  "model": "happyhorse-1.1-i2v",
  "prompt": "One continuous take, no cuts. The braided steam keeps thickening until the ribbons lock into one coral and ultraviolet serpent that uncoils along the ceiling, drops down past the stools and pours out through the open door into the rain, the cook in the orange jacket stepping back to let it pass. The camera holds at counter height, then tracks with the serpent to the doorway and tilts to watch it leave. One hard tungsten bulb overhead stays the only warm source. Real weight and inertia, visible density in the steam, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev/v1. El punto de entrada de la puerta de enlace es POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Crear una tarea

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {"prompt": "The cat runs across the grass as the camera follows smoothly.", "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}]},
    "parameters": {"resolution": "1080P", "duration": 5, "watermark": false}
  }'

Encuesta y descarga

Guardar el ID de la tarea. Sondear GET /v1/videos/{task_id} y descargar con GET /v1/videos/{task_id}/content. Las URL de resultados pueden caducar, así que transfiera el archivo lo antes posible.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Solicitar notas

HappyHorse usa input.prompt; elija la forma input.media que coincida con el ID del modelo t2v, i2v o r2v.

Solicitar parámetros

HappyHorse I2V coloca una imagen first_frame en input.media.

Campo	Requerido	Notas
model	Sí	happyhorse-1.1-i2v
input.prompt	No	Descripción opcional de movimiento y cámara, hasta 5000 caracteres no chinos o 2500 caracteres chinos
input.media[]	Sí	Exactamente uno first_frame; URL pública o URL de datos Base64, menos de 20 MB, lados mínimos de 300 px y relación de aspecto de 1:2,5 a 2,5:1
parameters.resolution	No	720P / 1080P, predeterminado 1080P
parameters.ratio	No	No compatible; la salida sigue la relación de imagen del primer fotograma
parameters.duration	No	3–15 segundos, predeterminado 5
parameters.watermark	No	Si se debe agregar la marca de agua HappyHorse
parameters.seed	No	Semilla opcional de 0 a 2.147.483.647

Límites de entrada y salida

I2V utiliza una imagen first_frame; acepte una URL pública o una URL de datos Base64 de menos de 20 MB con lados mínimos de 300 px y una relación de aspecto de 1:2,5 a 2,5:1, y conserve aproximadamente la relación de entrada.

Errores y tareas fallidas

Los parámetros del modelo no válidos devuelven un 4xx con un ID de solicitud. Una tarea asincrónica también puede fallar después de que la creación sea exitosa; utilice error_code y error_message de la respuesta de la encuesta como motivo final de la tarea. No vuelva a intentar la misma solicitud con una forma JSON diferente.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación de video por segundo. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.