Kandinsky 6.0 Pro
kandinsky-6.0-pro/text-to-video
Modelo de vídeo por difusão de código aberto que gera aproximadamente 5 segundos por vez com áudio sincronizado de 44 kHz e sincronia labial, oferece suporte a texto/imagem para vídeo e pode ser ampliado até Full-HD
Experimentar kandinsky-6.0-pro/text-to-video
Entrada
Saída
Preços
kandinsky-6.0-pro/text-to-video per video
| Preço unitário | $1.9286 |
|---|
Visão geral da posição
O modelo de geração de vídeo a partir de texto Kandinsky 6.0 Pro é voltado para desenvolvedores que precisam obter em uma única passagem imagens com áudio. Ele tem o prompt como única entrada obrigatória, produzindo áudio sincronizado junto com a geração das imagens, com saída de cerca de 5 segundos por vez, suportando proporções de tela como paisagem, retrato e quadrada, além de permitir definir uma semente aleatória para reproduzir resultados. É adequado para prototipagem de material de vídeos curtos, validação de cenas com dublagem e sincronização labial, e para equipes que iteram ideias rapidamente com prompts em inglês ou russo.
Destaques principais
- Imagem e áudio gerados de uma só vez — o prompt pode descrever simultaneamente o sujeito, a ação, a câmera e o som; imagem e áudio são produzidos no mesmo pipeline, dispensando o alinhamento posterior de dublagem.
- Controle de geração reproduzível — oferece o parâmetro seed; uma vez fixado, facilita a comparação versão a versão e a regressão com o mesmo prompt.
- Cobertura de múltiplas proporções de tela — suporta cinco formatos de saída: 16:9, 9:16, 1:1, 4:3 e 3:4, permitindo alternar diretamente entre paisagem, retrato e quadrado.
- Prompt e controle negativo separados — guidance_scale ajusta o grau de aderência ao prompt, enquanto negative_prompt declara separadamente o conteúdo a ser evitado.
Descrição das capacidades
Geração de vídeo com som a partir de prompt: basta inserir um prompt que descreva imagem e som para obter um clipe curto com áudio sincronizado; suporta nativamente prompts em inglês e russo, facilitando o controle direto do conteúdo e da atmosfera do vídeo em linguagem natural.
Alternância de proporção de tela: escolha entre paisagem, retrato e quadrado via aspect_ratio; o mesmo prompt pode rapidamente produzir versões adaptadas a diferentes posicionamentos.
Grau de aderência e restrições negativas: guidance_scale ajusta entre 1 e 10 o rigor de reprodução do texto, e negative_prompt serve para excluir elementos indesejados; a combinação dos dois reduz o escopo de tentativa e erro.
Reprodução por semente: seed pode fixar a aleatoriedade; se vazio, gera aleatoriamente, sendo adequado para travar resultados na fase de finalização ou realizar experimentos de controle na fase de ajuste de parâmetros.
Cenários de aplicação
- Produção rápida de material de vídeos curtos para redes sociais — operadores ou validadores de casos de uso inserem um prompt com descrição de imagem e efeitos sonoros e obtêm diretamente um vídeo de cerca de 5 segundos, usado como protótipo de material para veiculação em retrato ou quadrado.
- Validação de conceito de cena com dublagem — equipes criativas usam o prompt para descrever ações dos personagens e sons, gerando cenas curtas com áudio para demonstrar ritmo narrativo e atmosfera a clientes ou à equipe.
- Adaptação em lote para múltiplas proporções — desenvolvedores que precisam cobrir canais em paisagem e retrato com a mesma ideia fixam seed e prompt, alternam a proporção de tela e produzem várias versões de material, reduzindo ajustes repetitivos.
Limitações e recomendações de seleção
A saída por vez é um clipe curto de cerca de 5 segundos; vídeos longos narrativos exigem geração segmentada e posterior montagem. A geração com áudio significa que o prompt deve contemplar simultaneamente descrições de imagem e som; em composições complexas, pode ser necessário ajustar guidance_scale e o prompt negativo por várias rodadas até convergir. Atualmente suporta apenas entrada de texto; caso já existam materiais estáticos e se deseje que eles conduzam efeitos dinâmicos, deve-se usar a linha de geração de vídeo a partir de imagem da mesma série. Cenários com maiores exigências de duração e resolução do vídeo final precisam avaliar se devem ser combinados com processos posteriores, como super-resolução.
Criar uma tarefa de geração
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.
Idempotency-KeystringOpcionalChave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.
Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.
Corpo
modelstringObrigatórioValor fixo atual: kandinsky-6.0-pro/text-to-video
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para kandinsky-6.0-pro/text-to-video e a rota default — veja a tabela de parâmetros abaixo.
seedintegerOpcionalRandom seed for reproducing a generation. Omit for a random seed.
promptstringObrigatóriominLength 1maxLength 6000Describe the video and the sound you want. Write subject, action, camera and audio in one or two sentences. English and Russian prompts are supported natively.
aspect_ratiostringOpcionalPadrão: "16:9"Output frame. 16:9 and 4:3 are landscape, 9:16 and 3:4 vertical, 1:1 square.
16:99:161:14:33:4guidance_scalenumberOpcionalPadrão: 5min 1max 10How closely the result follows the prompt. Higher values follow the text more strictly.
negative_promptstringOpcionalmaxLength 2000What to avoid in the video. Leave empty to use the built-in negative prompt.
callbackobjectOpcional
Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.
Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.
urlstringObrigatórioObrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.
whenstringOpcionalPadrão: "final"Atualmente só há suporte a final — notifica tanto em success quanto em fail.
finalstoragestringOpcionalPadrão: "temp"Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.
temppersistentExemplos de requisição
# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kandinsky-6.0-pro/text-to-video",
"input": {
"prompt": "…",
"aspect_ratio": "16:9",
"guidance_scale": 5
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "kandinsky-6.0-pro/text-to-video",
input: {
"prompt": "…",
"aspect_ratio": "16:9",
"guidance_scale": 5
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "kandinsky-6.0-pro/text-to-video",
"input": {
"prompt": "…",
"aspect_ratio": "16:9",
"guidance_scale": 5
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obter detalhes da tarefa
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
queued Na fila, ainda não iniciada.
handling Em processamento.
archiving Processamento concluído, preparando artefatos.
success Terminal: concluído, artefatos disponíveis (retorna output).
fail Terminal: falha (retorna error).
Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.
creatednumberObrigatórioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos Unix do estado terminal; 0 enquanto não terminal.
outputarrayOpcional
Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).
Array [ object ]
Itens do array
urlstringObrigatórioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescrição do erro.
Exemplos de resposta
Sucesso
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Em processamento (não final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Falhou
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artigos
Ver todos os artigos →-
Tutorial
recraft-v4.1-flash geração de imagens por texto na prática: 5 cenários de negócio de alto valor e pontos de integração
Partindo de um custo de US$ 0,01 por imagem, planeje como aplicar a geração de imagens em negócios reais
-
Tutorial
Usar Kandinsky 6.0 Pro text-to-video na HiAPI: tutorial de curl e Python
Demonstração prática com foco na requisição: montar a chamada de prompt para clipe de vídeo, enviar a requisição, consultar o status de conclusão e baixar o resultado
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video na HiAPI: curl + Python
Faça uma requisição de imagem para vídeo funcional na HiAPI: do upload do primeiro quadro ao polling assíncrono e ao download final
-
Tutorial
Como chamar hailuo-2.3-fast/image-to-video pela API HiAPI: curl e Python na prática
A primeira requisição executável do nível rápido e econômico de geração de vídeo a partir de imagem — do ID do modelo ao download do MP4
-
Tutorial
Como usar kling-4.0/text-to-video através da API HiAPI: curl, Python e um exemplo de requisição executável
Guia prático para desenvolvedores: prompts cinematográficos, áudio sincronizado, polling assíncrono e download da saída
-
Avaliação comparativa
Comparação lado a lado do Recraft v4.1 Flash em text-to-image: guia de seleção e migração para desenvolvedores
Com um custo de $0.01 por imagem e capacidade de text-to-image pura, avalie se ele é adequado para seu pipeline de geração de imagens
-
Tutorial
Como chamar kling-4.0/image-to-video na HiAPI: curl, Python e polling
-
Tutorial
Como chamar hailuo-2.3/text-to-video pela API HiAPI: curl, Python e exemplos de requisição executáveis
-
Avaliação comparativa
hailuo-2.3-fast/image-to-video comparação lado a lado: como escolher modelos de imagem para vídeo e pontos de migração
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Kling 3.0 Turbo Kuaishou $0.130 /segundo -
Vidu Q4 Preview Vidu $0.051 /segundo -
Ray 3.2 Luma $0.214 /vídeo -
Runway Gen 4.5 Runway $0.172 /segundo -
Seedance 2.0 ByteDance $0.017 /segundo -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Kling 4.0 Kuaishou $0.330 /segundo -
HeyGen Avatar V HeyGen $0.150 /segundo -
Grok Imagine 1.5 xAI $0.011 /segundo -
Wan 2.7 Video Alibaba $0.100 /segundo -
Wan 3.0 Video Alibaba $0.040 /segundo -
FLUX 3 Video Black Forest Labs $0.090 /segundo