happyhorse-1.1-r2v API

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

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

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

Prompt: One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, no text.

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

{
  "model": "happyhorse-1.1-r2v",
  "prompt": "One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, 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-r2v",
    "input": {"prompt": "The person in [Image 1] picks up [Image 2].", "media": [{"type": "reference_image", "url": "https://example.com/person.jpg"}, {"type": "reference_image", "url": "https://example.com/object.jpg"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "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 R2V coloca de 1 a 9 elementos reference_image en input.media y hace referencia a ellos en orden desde el mensaje.

Campo	Requerido	Notas
model	Sí	happyhorse-1.1-r2v
input.prompt	Sí	Descripción de texto o instrucciones de referencia, hasta 5000 caracteres no chinos o 2500 caracteres chinos
input.media[]	Sí	1–9 reference_image elementos; URL pública o Base64, menos de 20 MB, mínimo 400 px en el lado corto
parameters.resolution	No	720P / 1080P, predeterminado 1080P
parameters.ratio	No	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9, predeterminado 16:9
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

R2V utiliza entre 1 y 9 elementos reference_image y se refiere a ellos en el orden indicado como Imagen 1, Imagen 2, etc. Las indicaciones están limitadas a 5000 caracteres no chinos o 2500 caracteres chinos; Las imágenes tienen menos de 20 MB y un lado corto mínimo de 400 píxeles.

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.