Kling V4 Flash

Contrato APIMaster para kling-v4-flash, verificado em 2026-11-07. Canal 317: texto, primeiro quadro, referências, edição e extensão. Apenas 720p, 24 fps, 3–20 segundos; modelo separado do Kling V4.

Kling V4 Flash

Endpoints e autenticação

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Parâmetros

JSON e Authorization: Bearer YOUR_API_KEY; model=kling-v4-flash. prompt obrigatório, exceto com um único quadro inicial. duration/seconds: inteiros JSON 3–20, padrão 5; null equivale a omissão, 0 é rejeitado. Ambos devem ser válidos e iguais. Edição sem duração usa o tempo do fluxo de vídeo arredondado para cima. resolution apenas 720p. aspect_ratio ou size: 16:9, 9:16, 1:1, 21:9; auto somente em referências. Padrões: texto 16:9, referência auto, edição segue a entrada. Imagem inicial e extensão rejeitam aspect_ratio/size não vazios. audio somente true, watermark somente false.

Parâmetro	Tipo JSON	Obrigatório	Padrão	Função e limites
model	string	Sim	kling-v4-flash	Sempre kling-v4-flash nas cinco operações; kling-v4 é outro modelo.
prompt	string	Por modo	—	Descreve cena, movimento ou alteração. Opcional apenas com uma imagem inicial. @Image1 e @Video1 são numerados separadamente desde 1 em cada array; o vídeo editado é @Video1.
duration	integer / null	Não	5	Inteiro JSON de 3–20 segundos, normalmente 5. Edição sem ambos os campos usa a duração da trilha de vídeo arredondada para cima; extensão indica o NOVO trecho. null equivale a omitir; 0, valores não inteiros e strings numéricas são rejeitados.
seconds	integer / null	Não	—	Alias de duration com os mesmos limites. Prefira um campo; se ambos existirem, precisam ser válidos e iguais, senão 400.
resolution	string	Não	720p	Apenas 720p: nível de qualidade, sem garantir lado menor de 720px. Não aceita 1080p nem seleção de qualidade por mode.
aspect_ratio	string	Não	Por modo	Texto/referência/edição: 16:9, 9:16, 1:1, 21:9; auto só para referência. Padrões: texto 16:9, referência auto, edição conforme origem. Imagem inicial/extensão rejeitam valor não vazio; string vazia equivale a omitir.
size	string	Não	—	Alias de aspect_ratio, não resolução nem tamanho em pixels. Ambos devem coincidir. Omita os dois para imagem inicial e extensão.
image_urls	string[]	Por modo	—	Array de URL públicas de imagens. Auto aceita uma imagem inicial; referência só com imagens exige reference explícito. Referência/edição: ≤10 imagens incluindo reference_image. Não misture representações do primeiro quadro; extensão não aceita imagens.
first_frame_image	string	Por modo	—	URL pública do único quadro inicial, alternativa a um item image_urls ou ao papel first_frame. Ambos os lados ≥300px, proporção 2:5–5:2; recorte antes se necessário.
image_with_roles	{url, role}[]	Por modo	—	Cada objeto exige url pública e role. first_frame para o único quadro inicial, reference_image para referência/edição. Sem quadros finais/intermediários/chave. Total de imagens de referência≤10, referências imagem/vídeo≤15.
video_url	string	Por modo	—	URL pública de um vídeo de origem com edit/extend explícito, exclusiva de video_urls. Edição: MP4/MOV, trilha 3–20s, cada dimensão 700–4553px. Extensão parte do último quadro e retorna só o trecho novo; não usar ID de tarefa/conversa.
video_urls	string[]	Por modo	—	Até 5 MP4/MOV de referência, cada trilha≥3s, cada dimensão 700–4553px, soma≤20s. Edit/extend explícitos podem usar um item no lugar de video_url. Excesso é rejeitado, não cortado; o array seleciona referência automaticamente.
omni_reference_task_type	string	Não	auto	auto identifica texto/imagem inicial/referência; reference exige material; edit/extend exigem um vídeo. video_url sem modo explícito e duas imagens comuns em auto são inválidos.
audio_setting	string	Não	auto	Somente referência COM VÍDEO. auto gera som novo; origin mantém o som do PRIMEIRO vídeo e, sem trilha na origem, a saída também não terá trilha. Omitir em edição, extensão, texto e referência só de imagens.
audio	boolean	Não	true	Booleano de compatibilidade: omitir ou true; false é rejeitado. Som original via audio_setting nos modos suportados; sem áudio de referência separado.
watermark	boolean	Não	false	Booleano de compatibilidade: omitir ou false; true é rejeitado. Não remove marcas d’água do material de entrada.

URL HTTP(S) públicas diretas sem credenciais embutidas; não base64/caminhos locais/ID de tarefa. Formatos e limites de bytes de imagens não foram especificados separadamente. 100MiB limita a leitura de cada vídeo analisado para referência/edição, não todos os uploads do fornecedor.

Modos e mídia

Operação	Seleção e material necessário	Padrões e exclusões
Texto para vídeo	Sem material, prompt obrigatório, tipo auto ou omitido.	5s, 16:9; sem audio_setting.
Imagem inicial para vídeo	Uma imagem por UMA das três representações; prompt opcional.	5s, proporção da imagem; sem aspect_ratio/size nem quadro final.
Referência para vídeo	reference + imagens, papéis reference_image ou video_urls; prompt obrigatório.	5s, auto; imagens≤10, vídeos≤5, total≤15; opção sonora só com vídeo.
Edição de vídeo	edit + um vídeo, prompt obrigatório; até 10 imagens de referência.	Duração da origem arredondada para cima, proporção da origem; sem papéis de quadro/audio_setting.
Extensão de vídeo	extend + um vídeo, prompt obrigatório.	5 segundos NOVOS; sem imagens, mudança de proporção/audio_setting; mínimos de dimensão/duração de edição/referência não se aplicam.

omni_reference_task_type: auto, reference, edit, extend. Uma imagem em image_urls, first_frame_image ou papel first_frame define o quadro inicial. Várias imagens exigem reference ou papéis reference_image; duas image_urls em auto são rejeitadas. video_urls usa referência salvo edit/extend explícito. video_url exige edit/extend e exclui video_urls. Edição/extensão exigem um vídeo. Edição admite imagens de referência; extensão não aceita imagens/audio_setting e retorna apenas o segmento NOVO. Use a URL pública do vídeo original, não IDs de tarefa ou conversa.

URLs HTTP(S) públicas diretas sem credenciais embutidas. Até 10 imagens, 15 referências de imagem/vídeo no total. Imagens de pelo menos 300×300, proporção 2:5–5:2. Até 5 MP4/MOV, cada um com pelo menos 3 segundos, total até 20; edição: um vídeo de 3–20 segundos. Largura E altura entre 700 e 4553 pixels. O gateway lê até 100 MiB por vídeo e mede a trilha de vídeo, não contêiner/áudio. Essas verificações de tamanho/duração mínima não valem para a entrada de extensão. O fornecedor também valida as imagens. audio_setting=origin mantém o áudio do primeiro vídeo de referência ou silêncio; auto gera áudio. Apenas referência COM vídeo. Edição gera áudio novo. Sem URLs de áudio, quadros finais/intermediários, keyframes, negative_prompt, mode, seed, múltiplas cenas ou listas de personagens/vozes.

Pixels de saída e taxa de quadros

Proporção / operação	Pixels documentados	Taxa de quadros
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Imagem inicial para vídeo	Proporção da imagem, cerca de 0,92MP; por exemplo 604×1516 para 2:5.	24 fps

As dimensões de saída não são requisitos de entrada. O 21:9 tem 628px de altura, abaixo dos 700px para referência/edição: prepare uma fonte compatível. Esse mínimo não vale para extensão. O arquivo pode durar cerca de um quadro a mais.

Exemplos sem execução

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Cobrança

Base oficial nominal: $0.094 por segundo de saída (720P), $0.0628 por segundo faturável com vídeo (720P-input). Texto, imagens, referências sem vídeo e extensão: saída/segmento novo. Referências com vídeo e edição: saída + max(entrada, saída). Some primeiro as durações das trilhas de entrada, depois arredonde a soma para cima. Entrada de 3.04 s e saída de 3 s: 3+max(4,3)=7 segundos faturáveis. Um quadro extra no arquivo não muda a duração inteira solicitada. Descontos de pacotes e multiplicadores da conta são separados; consulte o cartão e o valor final no registro. Falha confirmada devolve a reserva. Parar de consultar não cancela a tarefa; timeout ambíguo não autoriza outra geração.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Consulta, erros e repetição segura

Primeira aceitação: HTTP 200, task_id público, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed e possível unknown temporário. url e metadata.url exigem Bearer; também GET /v1/videos/{task_id}/content. Falha: error.code=generation_failed com mensagem sanitizada; parâmetros inválidos: HTTP 400. Idempotency-Key: 8–128 caracteres ASCII visíveis sem espaços. Mesma conta/chave/requisição: HTTP 202 sem nova geração/reserva; alteração: 409. GET /v1/video-submissions/by-key lê o recibo. accepted+task_ready=true: consultar task_id; pending/submitting ou não pronto: aguardar. acceptance_unknown: guardar a chave e contatar suporte, sem reenvio automático. 404 não prova não aceitação. Retenção mínima 30 dias; proteção do gateway, sem busca no fornecedor. Valor final no consumo por other.task_id; consulta de tarefa não garante fatura. /v1/videos/quote não suportado. Exemplos inertes: substitua URLs e use chave nova em cada nova operação.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI