happyhorse-1.1-i2v API

Use o ID exato do modelo happyhorse-1.1-i2v. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídahappyhorse-1.1-i2vPOST /v1/videos5.2s

Parâmetros: duration=5resolution=1080pratio=16:9Imagem 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.

Solicitação que produziu esta amostra, com a URL da mídia de entrada substituída

{
  "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"
}

Autenticação e endpoint

Use uma chave de API Modelflare com https://modelflare.dev/v1. O ponto de entrada do gateway é POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Criar uma tarefa

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}
  }'

Pesquisa e download

Salve o ID da tarefa. Enquete GET /v1/videos/{task_id} e download com GET /v1/videos/{task_id}/content. Os URLs de resultados podem expirar, portanto transfira o arquivo imediatamente.

bash

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

Solicitar notas

HappyHorse usa input.prompt; escolha a forma input.media que corresponde ao ID do modelo t2v, i2v ou r2v.

Parâmetros de solicitação

HappyHorse I2V coloca uma imagem first_frame em input.media.

Campo	Obrigatório	Notas
model	Sim	happyhorse-1.1-i2v
input.prompt	Não	Descrição opcional de movimento e câmera, até 5.000 caracteres não chineses ou 2.500 caracteres chineses
input.media[]	Sim	Exatamente um first_frame; URL público ou URL de dados Base64, menos de 20 MB, lados mínimos de 300 px e proporção de 1:2,5–2,5:1
parameters.resolution	Não	720P / 1080P, padrão 1080P
parameters.ratio	Não	Não suportado; a saída segue a proporção da imagem do primeiro quadro
parameters.duration	Não	3–15 segundos, padrão 5
parameters.watermark	Não	Se deve adicionar a marca d’água HappyHorse
parameters.seed	Não	Semente opcional de 0 a 2.147.483.647

Limites de entrada e saída

I2V usa uma imagem first_frame; aceite um URL público ou URL de dados Base64 com menos de 20 MB com lados mínimos de 300px e uma proporção de 1:2,5–2,5:1 e preserve aproximadamente a proporção de entrada.

Erros e tarefas com falha

Parâmetros de modelo inválidos retornam um 4xx com um ID de solicitação. Uma tarefa assíncrona também pode entrar com falha após a criação ser bem-sucedida; use error_code e error_message da resposta da enquete como o motivo final da tarefa. Não tente novamente a mesma solicitação com um formato JSON diferente.

Escopo suportado

Esta página cobre chamadas de geração e edição de modelo Modelflare. O enriquecimento de pesquisa ou mapa, gerenciamento de voz e gerenciamento de biblioteca de elementos são APIs de recursos fora dessa superfície pública de chamada de modelo e não são campos de solicitação obrigatórios.

Preços e cobrança

Este modelo utiliza cobrança de vídeo por segundo. Consulte a página de preços do modelo para obter o preço atual do cliente, a lista de preços de referência e as especificações completas.

Nota

Esta página documenta a interface pública do Modelflare; os campos e limites mostrados aqui são o contrato atual.