happyhorse-1.1-t2v API

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

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

Parâmetros: duration=5resolution=1080pratio=16:9

Prompt: One continuous take, no cuts. An arcade after closing, cabinets still on, carpet glowing under blacklight. A figure in a holographic windbreaker slaps the side of one cabinet and its picture comes off the screen: the pixels lift as solid coloured tiles, swarm out across the aisle and pull the pictures off every other machine with them, until the whole room is a moving cloud of cyan and hot pink squares. The camera tracks sideways down the aisle and turns into the swarm as it builds. One hard cyan key from the nearest screen, deep violet ambient. Real weight and inertia, each tile catching light separately, no text.

Solicitação que produziu esta amostra

{
  "model": "happyhorse-1.1-t2v",
  "prompt": "One continuous take, no cuts. An arcade after closing, cabinets still on, carpet glowing under blacklight. A figure in a holographic windbreaker slaps the side of one cabinet and its picture comes off the screen: the pixels lift as solid coloured tiles, swarm out across the aisle and pull the pictures off every other machine with them, until the whole room is a moving cloud of cyan and hot pink squares. The camera tracks sideways down the aisle and turns into the swarm as it builds. One hard cyan key from the nearest screen, deep violet ambient. Real weight and inertia, each tile catching light separately, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

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-t2v",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "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 T2V usa input.prompt para gerar um vídeo.

Campo	Obrigatório	Notas
model	Sim	happyhorse-1.1-t2v
input.prompt	Sim	Descrição de texto ou instruções de referência, até 5.000 caracteres não chineses ou 2.500 caracteres chineses
input.media[]	Não	—
parameters.resolution	Não	720P / 1080P, padrão 1080P
parameters.ratio	Não	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9, padrão 16:9
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

T2V necessita apenas de input.prompt; os prompts são limitados a 5.000 caracteres não chineses ou 2.500 caracteres chineses, a saída é 720P ou 1080P com nove valores de proporção e a duração é de 3 a 15 segundos.

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.