Guia de uso
Quando a API do Kling 4.0 estará disponível? O que a oficial divulgou e o que usar agora
O Kling 4.0 foi lançado em 28 de setembro, mas ainda não tem API pública. Os recursos divulgados oficialmente, a data de lançamento e como começar a trabalhar agora com o Kling 3.0.
Conclusão primeiro: o Kling 4.0 ainda não tem API pública. O Kuaishou lançou o Kling 4.0 em 28 de setembro de 2026 e, segundo relatos, a versão completa está prevista para outubro de 2026, mas sem data específica. O que está disponível agora é apenas a versão Flash, liberada em pequena escala dentro dos próprios produtos do Kling, sem API e sem preço divulgado. O HiAPI já tem a página de prévia do Kling 4.0, onde é possível cadastrar um alerta de lançamento.
Até lá, o que pode ser chamado é o Kling 3.0. O código abaixo coloca o nome do modelo como item de configuração, assim, para mudar para o 4.0 no futuro, basta alterar um nome de modelo.
O que a oficial divulgou
Com base nas reportagens da época do lançamento (SlopTV, GuruFocus):
| Item | Divulgado oficialmente | Disponível agora |
|---|---|---|
| Duração por clipe | Até 30 segundos | Flash: 3–20 segundos |
| Keyframes | Até 10 imagens | Ainda indisponível |
| Referências multimodais | Até 15 por vez | Ainda indisponível |
| Resolução | Até 4K | Flash: até 720p |
| Data de lançamento | Versão completa em outubro de 2026, sem data específica | Flash liberado em pequena escala desde 28 de setembro |
| API e preço | Não divulgados | Nenhum |
Os números acima são os divulgados oficialmente, não medidos por nós. Atualizaremos esta página quando o Kling 4.0 puder ser chamado no HiAPI.
Disponível agora: Kling 3.0
No HiAPI, o Kling 3.0 tem três linhas, todas usando a mesma interface POST /v1/tasks:
| Modelo | Entrada | 720p / seg | 1080p / seg | 4K / seg |
|---|---|---|---|---|
Kling 3.0 kling-3.0/* |
Texto para vídeo, imagem para vídeo (primeiro frame ou primeiro e último frames) | $0.10, com áudio $0.143 | $0.129, com áudio $0.193 | $0.479 |
Kling 3.0 Omni kling-3.0-omni/* |
Texto para vídeo, imagem para vídeo, referência para vídeo, reescrita de vídeo | $0.10, com áudio $0.129 | $0.129, com áudio $0.1645 | $0.479 |
Kling 3.0 Turbo kling-3.0-turbo/* |
Texto para vídeo, imagem para vídeo | $0.13 | $0.16 | — |
Preços atuais do HiAPI, verificados em 15 de outubro de 2026; falhas não são cobradas.
Exemplo do Kling 3.0 na página do modelo, 5 segundos:
A lone red fox sprints across a windswept snowy ridge at golden hour, powder snow kicking up behind each stride, then leaps over a frozen creek in a graceful arc. Cinematic, dramatic side lighting, ultra-detailed fur, shallow depth of field, smooth motion.
Gerar com este prompt → (5 segundos, 16:9)
Exemplo da página do modelo kling-3.0/text-to-video, 5 segundos. Custa $0.50 em 720p sem áudio.
Escreva um código que já possa migrar direto para o 4.0
Coloque o nome do modelo na configuração; o formato da requisição não muda. No HiAPI, todos os modelos de vídeo usam a mesma interface de tarefas; trocar de modelo geralmente é só mudar a configuração e acrescentar os parâmetros extras do novo modelo.
import os, time, uuid, requests
API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
KLING_MODEL = os.environ.get("KLING_MODEL", "kling-3.0/text-to-video") # troque aqui no futuro
def generate(prompt: str, **params) -> str:
r = requests.post(API, json={"model": KLING_MODEL, "input": {"prompt": prompt, **params}},
headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
r.raise_for_status()
task_id = r.json()["data"]["taskId"]
while True:
data = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
if data["status"] == "success":
return data["output"][0]["url"]
if data["status"] == "fail":
raise RuntimeError(data.get("error"))
time.sleep(10)
print(generate("金色夕阳下,一只红狐在雪脊上疾奔,平滑跟拍",
duration=5, resolution="720p", aspect_ratio="16:9", sound=False))
Para parâmetros completos, imagem para vídeo e tratamento de erros, veja o tutorial em chinês da API do Kling 3.0.
Enquanto espera o 4.0, como escolher o Kling 3.0
- Se precisa de diálogo, efeitos sonoros, múltiplos planos ou 4K: use
kling-3.0, com referência ao guia de prompts do Kling 3.0. - Se precisa fixar personagens ou produtos com imagens de referência, ou seguir o movimento de um vídeo de referência: use
kling-3.0-omni, veja o tutorial em chinês do Kling 3.0 Omni. - Se tem apenas um primeiro frame, quer um preço único simples e o áudio já incluso: use
kling-3.0-turbo.
Perguntas frequentes
Quando a API do Kling 4.0 estará disponível?
O Kuaishou disse que a versão completa será lançada em outubro de 2026, mas não informou uma data específica nem anunciou a abertura da API. Quando o Kling 4.0 puder ser chamado e o preço estiver definido, o HiAPI o disponibilizará o quanto antes; você pode cadastrar um alerta na página do modelo.
Quanto custa o Kling 4.0?
O preço ainda não foi divulgado. Os preços só aparecem na página do modelo depois que ele puder ser chamado no HiAPI.
É possível usar o Kling 4.0 Flash via API?
No momento, não. A versão Flash só está disponível em pequena escala nos próprios produtos do Kling.
O código escrito agora para o Kling 3.0 poderá ser usado diretamente no 4.0 no futuro?
No HiAPI, o fluxo de envio, polling e download não muda. Novos recursos, como mais keyframes e mais referências, provavelmente trarão novos parâmetros; basta consultar a documentação quando estiverem disponíveis.
Comece a trabalhar agora com o Kling 3.0: vá à página do modelo para gerar o vídeo da raposa vermelha.
Artigos relacionados
Ver todos os artigos →-
Guia de uso
Guia de introdução ao seedream-5.0-pro/image-to-image: capacidades, preços e pontos de integração
Limites de capacidade, modelo de cobrança e práticas de integração de engenharia do modelo de edição de imagem da ByteDance
-
Guia de uso
Guia prático do seedream-5.0-pro text-to-image: limites de capacidade, integração via API e controle de custos
Perspectiva prática para desenvolvedores: dos pontos-chave dos parâmetros à estimativa de custo de US$ 0,05 por imagem
-
Guia de uso
Guia de introdução ao Hailuo 2.3 Fast image-to-video: limites de capacidade, preços e práticas de integração
Pontos-chave de seleção e integração do modelo image-to-video MiniMax para desenvolvedores