kling-3.0 API

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

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

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

Prompt: Stop-motion claymation style: a small orange clay fox sneaks through a miniature felt forest, pauses, sniffs a glowing mushroom and jumps back in surprise. Handmade textures, visible fingerprints on the clay, soft tabletop lighting, charming and playful, no text.

Solicitação que produziu esta amostra

{
  "model": "kling-3.0",
  "prompt": "Stop-motion claymation style: a small orange clay fox sneaks through a miniature felt forest, pauses, sniffs a glowing mushroom and jumps back in surprise. Handmade textures, visible fingerprints on the clay, soft tabletop lighting, charming and playful, 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",
    "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 Legacy usa model_name com as estruturas de solicitação text2video/image2video. Verifique a página oficial do modelo e a página de preços para modo, resolução e faixas de áudio.

Campo	Obrigatório	Notas
model_name	Sim	kling-3.0
prompt	Condicional	Obrigatório para conversão de texto em vídeo; combinar com imagens para imagem para vídeo
image	Condicional	URL da imagem do primeiro quadro ou Base64
image_tail	Não	Imagem de quadro final opcional
video_url	Condicional	Vídeo de referência para controle de movimento Kling 3.0
image_list	Não	Lista de imagens para fluxos de trabalho Omni/O1 e multimodais
negative_prompt	Não	Alerta negativo
mode	Não	std / pro / 4k (dependente do modelo)
duration	Não	3–15 segundos (sequência)
multi_shot	Não	Habilitar storyboard de múltiplas tomadas
sound	Não	Gere som sincronizado onde houver suporte
camera_control	Não	Controle de câmera onde houver suporte

Limites de entrada e saída

Solicitações Kling Legacy usam model_name; a disponibilidade de mode, duration, image / image_tail, sound e camera_control depende do modelo. Os segundos faturáveis mínimos e as faixas de resolução seguem as linhas por modelo na página de preços.

Exemplos de fluxo de trabalho documentados

Os modelos legados selecionam model_name, primeiro quadro/final ou campos de controle de movimento por fluxo de trabalho; duração fixa e limites de áudio seguem a tabela desta página.

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", "prompt": "转移动作并保持人物身份",
    "image": "https://example.com/character.png",
    "video_url": "https://example.com/motion.mp4",
    "duration": "5", "mode": "std"
  }'

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.