kling-o1 API

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

Exemplo de saídakling-o1POST /v1/videos5.0s

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

Prompt: One continuous take, no cuts. A long subway escalator at night, tiled tunnel, nobody else on it. A figure in an oversized violet coat rides down with one hand on the rail; where the hand passes, the handrail stops being rubber and becomes a running river of liquid mercury that keeps flowing down both sides and pools at the bottom of the shaft, throwing the tunnel lights back as broken silver. The camera descends ahead of the figure, facing back up the escalator, and tilts down as the mercury reaches the floor. One hard cold key from the tunnel strip lights, a warm amber glow rising from the pool. Real weight and inertia, metal surface tension, no text.

Solicitação que produziu esta amostra

{
  "model": "kling-o1",
  "prompt": "One continuous take, no cuts. A long subway escalator at night, tiled tunnel, nobody else on it. A figure in an oversized violet coat rides down with one hand on the rail; where the hand passes, the handrail stops being rubber and becomes a running river of liquid mercury that keeps flowing down both sides and pools at the bottom of the shaft, throwing the tunnel lights back as broken silver. The camera descends ahead of the figure, facing back up the escalator, and tilts down as the mercury reaches the floor. One hard cold key from the tunnel strip lights, a warm amber glow rising from the pool. Real weight and inertia, metal surface tension, 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_name": "kling-o1",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "duration": "5", "mode": "std"
  }'

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

Kling usa campos model_name, prompt, mode, duration, image_list ou contents / settings específicos da família; JSON nativo é preservado e encaminhado.

Parâmetros de solicitação

Kling Omni/O1 usa model_name, prompt e listas de mídia. Siga as restrições oficiais de cada modelo ao combinar image_list, video_list, element_list, multi_shot e sound.

Campo	Obrigatório	Notas
model_name	Sim	kling-o1
prompt	Condicional	Necessário quando o disparo múltiplo está desabilitado
mode	Não	std / pro
aspect_ratio	Condicional	16:9 / 9:16 / 1:1
duration	Não	3–15 segundos (sequência)
image_list	Não	Referências de primeiro/final quadro, cena ou estilo; Omni/O1 permite vários itens dentro dos limites do modelo
video_list	Não	Edição de vídeo ou referências de estilo
element_list	Não	IDs dos elementos Kling; esta integração não fornece gerenciamento de elementos
multi_shot	Não	Habilitar storyboard de múltiplas tomadas
sound	Não	Se deve gerar som sincronizado

Limites de entrada e saída

O1 suporta 720p/1080p, 3–10 segundos e referências de imagem/vídeo/elemento. Desative sound quando video_list estiver presente; 4k e multi-shot não são suportados.

Exemplos de fluxo de trabalho documentados

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-o1",
    "prompt": "让图 1 中的人物在雨中向镜头挥手",
    "image_list": [{"image_url": "https://example.com/character.png"}],
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

Vídeos de referência, elementos e combinações multi-shot devem seguir os limites desta página; desligue sound quando um vídeo de referência estiver presente.

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.