MiniMax-H3 API

Use o ID exato do modelo MiniMax-H3. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídaMiniMax-H3POST /v1/videos5.2s

Parâmetros: duration=5resolution=2Kratio=16:9

Prompt: A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

Solicitação que produziu esta amostra

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "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": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

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

MiniMax-H3 usa content[] com resolution, duration e ratio controlando a saída.

Parâmetros de solicitação

MiniMax-H3 usa uma matriz multimodal content[]. Pesquise o caminho de consulta do MiniMax após a criação da tarefa; As funções first_frame/last_frame e reference_* são fluxos de trabalho distintos.

Campo	Obrigatório	Notas
model	Sim	MiniMax-H3
content[]	Sim	Exatamente um item text; pode incluir first_frame, last_frame, reference_image, reference_video ou reference_audio
resolution	Sim	768P / 2K
duration	Sim	4–15 segundos
ratio	Condicional	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	Condicional	Use first_frame / last_frame para imagem para vídeo e reference_* para fluxos de trabalho de referência; não misture os grupos
content[].url	Não	URL HTTP/HTTPS público obrigatório; A mídia Base64 não é suportada
aigc_watermark	Não	Se deve adicionar uma marca d’água
callback_url	Não	URL de retorno de chamada de status da tarefa

Limites de entrada e saída

A saída é 768P ou 2K por 4–15 segundos. Solicitações somente de texto precisam de um ratio concreto; imagem para vídeo permite um primeiro quadro e um último quadro, enquanto os fluxos de trabalho de referência exigem pelo menos uma imagem ou vídeo de referência e não podem usar apenas áudio. Não misture os dois grupos de funções.

Exemplos de fluxo de trabalho documentados

MiniMax-H3 URLs de mídia devem ser acessíveis publicamente e não podem usar Base64; Os fluxos de trabalho de primeiro/fim quadro e referência não devem ser misturados.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

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.

Variantes

ID do modelo	Diferença
MiniMax-H3	O modelo documentado nesta página.