happyhorse-1.1-r2v API

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

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

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

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

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

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

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 R2V coloca 1–9 reference_image itens em input.media e os referencia em ordem no prompt.

Campo	Obrigatório	Notas
model	Sim	happyhorse-1.1-r2v
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[]	Sim	1–9 reference_image itens; URL público ou Base64, menos de 20 MB, lado curto mínimo de 400px
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

R2V usa itens de 1 a 9 reference_image e refere-se a eles na ordem imediata como Imagem 1, Imagem 2 e assim por diante. As solicitações são limitadas a 5.000 caracteres não chineses ou 2.500 caracteres chineses; as imagens têm menos de 20 MB com um lado curto mínimo de 400px.

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.