O que Extensão de Vídeo Kling AI faz?
Visão Geral
Estenda um vídeo existente adicionando segundos extras. O endpoint de extensão recebe o task_id de um vídeo concluído e gera uma continuação contínua.
Endpoint: POST https://api.klingai.com/v1/videos/video-extend
Parâmetros da Requisição
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
task_id | string | Sim | ID da tarefa do vídeo de origem concluído |
prompt | string | Não | Descrição de movimento/cena para a extensão |
duration | string | Não | Duração da extensão: "5" (padrão) |
mode | string | Não | "standard" ou "professional" |
model_name | string | Não | Padrão: "kling-v2-master" |
callback_url | string | Não | Webhook para conclusão |
Extensão Básica
import jwt, time, os, requests
BASE = "https://api.klingai.com/v1"
def get_headers():
ak, sk = os.environ["KLING_ACCESS_KEY"], os.environ["KLING_SECRET_KEY"]
token = jwt.encode(
{"iss": ak, "exp": int(time.time()) + 1800, "nbf": int(time.time()) - 5},
sk, algorithm="HS256", headers={"alg": "HS256", "typ": "JWT"}
)
return {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
# Etapa 1: Gerar o vídeo inicial de 5s
initial = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Um foguete lançando de uma paisagem desértica, cinematográfico",
"duration": "5",
"mode": "standard",
}).json()
initial_task_id = initial["data"]["task_id"]
# Aguarde a conclusão...
# (faça polling até task_status == "succeed")
# Etapa 2: Estender por mais 5 segundos
extension = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": initial_task_id,
"prompt": "O foguete sobe através de nuvens para a estratosfera",
"duration": "5",
"mode": "standard",
}).json()
ext_task_id = extension["data"]["task_id"]
# Etapa 3: Fazer polling da tarefa de extensão
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/video-extend/{ext_task_id}", headers=get_headers()
).json()
if result["data"]["task_status"] == "succeed":
extended_url = result["data"]["task_result"]["videos"][0]["url"]
print(f"Vídeo estendido: {extended_url}")
break
elif result["data"]["task_status"] == "failed":
print(f"Falhou: {result['data']['task_status_msg']}")
break
Encadear Múltiplas Extensões
def chain_extensions(initial_task_id: str, prompts: list[str],
duration: str = "5", mode: str = "standard") -> list[str]:
"""Encadeia múltiplas extensões para construir um vídeo mais longo."""
current_task_id = initial_task_id
video_urls = []
for i, prompt in enumerate(prompts):
print(f"Extensão {i + 1}/{len(prompts)}: enviando...")
# Enviar extensão
r = requests.post(f"{BASE}/videos/video-extend", headers=get_headers(), json={
"task_id": current_task_id,
"prompt": prompt,
"duration": duration,
"mode": mode,
}).json()
ext_task_id = r["data"]["task_id"]
# Fazer polling até conclusão
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/video-extend/{ext_task_id}", headers=get_headers()
).json()
status = result["data"]["task_status"]
if status == "succeed":
url = result["data"]["task_result"]["videos"][0]["url"]
video_urls.append(url)
current_task_id = ext_task_id # próxima extensão encadeia a partir desta
print(f"Extensão {i + 1} completa: {url}")
break
elif status == "failed":
raise RuntimeError(f"Extensão {i + 1} falhou: {result['data']['task_status_msg']}")
return video_urls
Uso: Construir um Vídeo de 20 Segundos
# Gerar inicial de 5s
initial_r = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-master",
"prompt": "Nascer do sol sobre um lago na montanha, névoa subindo",
"duration": "5",
"mode": "standard",
}).json()
initial_id = initial_r["data"]["task_id"]
# ... faça polling até completo ...
# Encadear 3 extensões extras = 5 + 5 + 5 + 5 = 20 segundos total
extensions = chain_extensions(initial_id, [
"O sol sobe mais alto, pássaros começam a voar sobre o lago",
"Um cervo se aproxima da beira da água para beber",
"Plano aberto recuando para revelar toda a cordilheira",
])
Custo
Cada extensão custa o mesmo que uma nova geração:
| Duração da Extensão | Standard | Professional |
|---|---|---|
| 5 segundos | 10 créditos | 35 créditos |
Um vídeo de 20 segundos (inicial + 3 extensões) custa 40 créditos no modo standard.
Tratamento de Erros
| Erro | Causa | Correção |
|---|---|---|
task_id inválido | A tarefa de origem não existe | Verifique se o task_id é de uma geração concluída |
| Origem não concluída | Estendendo uma tarefa ainda em processamento | Aguarde a tarefa de origem atingir o status succeed |
| Extensão falhou | Conflito de prompt com a origem | Alinhe o prompt da extensão com a cena original |
Pré-requisitos
- Um rascunho de origem concluído, com direitos autorais limpos ou sintético, um resumo de extensão aprovado, um workspace autorizado e orçamento de créditos, revisão de políticas, destino apenas como rascunho, e um proprietário para reversão/remoção.
Instruções
- Confirme a propriedade da origem, o estado de conclusão e o resumo de continuidade aprovado antes de criar uma extensão; não use material privado, sem licença ou restrito por políticas.
- Envie um rascunho canário com marca d'água dentro da duração e limite de créditos aprovados, depois verifique políticas, direitos, qualidade e controles de destino.
- Pare em caso de desvios de continuidade, política, direitos ou orçamento e exclua a tarefa de extensão em vez de publicá-la.
- Promova somente após aprovação do proprietário; mantenha um recibo editado e remova ativos temporários no período de retenção acordado.
Saída
Produza um recibo de extensão com referência da tarefa de origem, classificação de direitos, modo/duração, estimativa de créditos, revisão de políticas, destino do rascunho, aprovador, referência de retenção/remoção e ID da tarefa. Exclua prompts, identidades e URLs de ativos.
Exemplos
source=synthetic-task-42; rights=cleared; duration=5s; mode=standard; policy=pass; destination=draft-only; cleanup=24h é seguro para revisão.