kling-3.0-omni API

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

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

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

Prompt: One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, no text.

Solicitação que produziu esta amostra

{
  "model": "kling-3.0-omni",
  "prompt": "One continuous take, no cuts. A concrete rooftop at golden hour, the city low and hazy behind. A model in a chrome moulded dress stands still with arms down while loose fabric panels fly in from off frame, hundreds of them in coral, ultraviolet and bronze, and assemble around her into a vast sculpted train that keeps growing past the roof edge. The camera orbits her a full half turn at chest height and rises as the train forms. One hard low sun from the left, deep cool shadow on the right. Real weight and inertia, cloth snapping in the wind, 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-3.0-omni",
    "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-3.0-omni
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

Omni suporta 720p/1080p/4k, 3–15 segundos, referências de imagem/vídeo/elemento e até seis tomadas de storyboard. Desative sound quando um vídeo de referência estiver presente.

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-3.0-omni",
    "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.