Veo 3.1 Lite
veo-3.1-lite/text-to-video
Nível de geração de vídeo do Google com baixo custo e alta taxa de transferência, com velocidade equivalente ao Veo 3.1 Fast, compatível com geração de vídeo a partir de imagem, várias proporções de tela e durações
Experimentar veo-3.1-lite/text-to-video
Entrada
Criações
Ver todas as criaçõesSaída
videoPreços
veo-3.1-lite/text-to-video per second
Apresentação e posicionamento
veo-3.1-lite/text-to-video é a rota de texto para vídeo da família Google Veo 3.1 Lite, voltada para desenvolvedores que precisam produzir vídeos curtos em lote. Basta inserir um prompt em linguagem natural para gerar clipes de vídeo com áudio nativo, com suporte a 720p/1080p, proporções 16:9 e 9:16, durações de 4/6/8 segundos e controle do resultado por meio de parâmetros como seed e negative_prompt. Indicado para cenários de engenharia sensíveis a custo e velocidade de iteração, como vídeos publicitários curtos, conteúdo para redes sociais e geração de vídeo dentro de produtos, com chamadas pela interface unificada do HiAPI.ai.
Principais destaques
- Suporte a geração de áudio nativo — o áudio é produzido junto com as imagens, ativado por padrão e pode ser desativado conforme a necessidade para se adaptar a fluxos de edição sem som.
- Cobertura de formatos horizontal e vertical — proporções 16:9 e 9:16 integradas, atendendo simultaneamente à distribuição de conteúdo em paisagem e retrato com uma única integração.
- Duração e resolução selecionáveis — três opções de duração (4, 6 e 8 segundos) combinadas com resolução 720p/1080p, facilitando o equilíbrio entre qualidade final e custo conforme o cenário.
- Parâmetros de controle completos — oferece seed para reprodução, negative_prompt para excluir conteúdo, auto_fix para correção do prompt e tolerância de segurança, entre outros ajustes.
Descrição de capacidades
Geração de vídeo a partir de prompt: descreve a cena em linguagem natural e gera o clipe correspondente, sendo a forma básica de entrada para construir linhas automatizadas de produção de vídeo.
Saída de áudio nativo: o resultado gerado inclui áudio sincronizado, dispensando etapas posteriores de dublagem e montagem de efeitos sonoros; quando desativado, obtém-se material silencioso.
Saída em múltiplas especificações: combina os parâmetros resolution, aspect_ratio e duration para obter a especificação desejada, com saída pronta para entrar no fluxo de edição ou veiculação.
Resultado controlável e reproduzível: fixar o seed reproduz o mesmo resultado de geração, negative_prompt evita elementos indesejados e auto_fix reescreve automaticamente o prompt em caso de falha de validação, reduzindo a taxa de falha das chamadas.
Cenários de aplicação
- Produção em lote de anúncios curtos por equipes de marketing — insira o tema da campanha e a descrição dos pontos de venda para gerar em lote clipes de 8 segundos com áudio, usados em testes de criativos e iterações rápidas de A/B.
- Vídeos verticais para produtores de conteúdo em redes sociais — gera clipes curtos em proporção 9:16, prontos para atualização de conteúdo em plataformas de vídeo curto e feeds sociais.
- Integração de recursos de vídeo por desenvolvedores de produto — chama a geração de vídeo por prompt de forma automatizada dentro do produto, oferecendo-a como módulo funcional aos usuários finais.
- Pré-visualização de roteiro por equipes criativas — converte rapidamente o texto do storyboard em clipes de 4 segundos e, com seed fixo para reproduzir a proposta, apoia a confirmação visual na fase de apresentação.
Limitações e recomendações de escolha
A duração máxima por geração é de 8 segundos e a resolução máxima é 1080p, não sendo adequado para vídeos longos, narrativas contínuas ou necessidades de maior nitidez no produto final; projetos complexos que exigem movimentos de câmera precisos e continuidade entre planos devem ser divididos em vários trechos gerados e depois editados. O parâmetro de tolerância de segurança limita a produção de conteúdo de determinados temas. Caso a tarefa parta de uma imagem, deve-se escolher a rota de imagem para vídeo da mesma família, e não esta rota.
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: veo-3.1-lite/text-to-video
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para veo-3.1-lite/text-to-video e a rota default — veja a tabela de parâmetros abaixo.
seedintegerOpcionalSemente aleatória usada para gerar resultados reproduzíveis; ao passar a mesma semente e os mesmos parâmetros, obtém-se uma saída de vídeo consistente. Se não for fornecida, o servidor decide aleatoriamente.
promptstringObrigatóriominLength 1Prompt de texto que descreve o conteúdo do vídeo a ser gerado; é a entrada principal para texto-para-vídeo.
auto_fixbooleanOpcionalPadrão: trueSe os prompts que não passam na validação devem ser reescritos automaticamente. Padrão: true.
durationintegerOpcionalPadrão: 8min 4max 8Duração do clipe de vídeo gerado, em segundos. Padrão: 8 segundos.
468resolutionstringOpcionalPadrão: "720p"Resolução do vídeo de saída. Padrão: 720p.
720p1080paspect_ratiostringOpcionalPadrão: "16:9"Proporção de tela do vídeo de saída. Padrão: 16:9.
16:99:16generate_audiobooleanOpcionalPadrão: trueSe deve gerar áudio nativo local. Padrão: true.
negative_promptstringOpcionalPrompt negativo que especifica o conteúdo a ser evitado no vídeo gerado.
safety_tolerancestringOpcionalPadrão: "4"Nível de tolerância da moderação de conteúdo. Padrão: "4".
123456callbackobjectOpcional
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": "veo-3.1-lite/text-to-video",
"input": {
"prompt": "…",
"auto_fix": true,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"safety_tolerance": "4"
}
}' 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: "veo-3.1-lite/text-to-video",
input: {
"prompt": "…",
"auto_fix": true,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"safety_tolerance": "4"
}
}),
});
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": "veo-3.1-lite/text-to-video",
"input": {
"prompt": "…",
"auto_fix": True,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": True,
"safety_tolerance": "4"
}
},
)
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
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 chamar kling-4.0/image-to-video na HiAPI: curl, Python e polling
-
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 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
-
Tutorial
Como chamar hailuo-2.3/text-to-video pela API HiAPI: curl, Python e exemplos de requisição executáveis
-
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
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Veo 3.1 Fast Google $0.170 /segundo -
LTX 2.5 Fast Lightricks $0.086 /segundo -
Wan 2.7 Video Alibaba $0.100 /segundo -
Vidu Q3 Vidu $0.149 /segundo -
Kling AI Avatar Kuaishou -- -
Veo 3.1 Google $0.290 /segundo -
Seedance 2.5 ByteDance $0.121 /segundo -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Grok Imagine 1.5 Lite xAI $0.029 /segundo -
MiniMax H3 MiniMax $0.072 /segundo -
Wan 2.6 Flash Alibaba $0.043 /segundo -
HappyHorse 1.1 Alibaba $0.160 /segundo
Mesmo provedor
-
Nano Banana 2 Google $0.036 /imagem -
Veo 3.1 Google $0.290 /segundo -
Nano Banana Google $0.021 /imagem -
Google Virtual Try-On Google $0.107 /imagem -
Nano Banana 2 Lite Google $0.033 /imagem -
Lyria 3 Pro Google $0.140 /música -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Gemini 3.1 Flash TTS Google -- -
Lyria 3.5 Google $0.090 /música -
Nano Banana Pro Google $0.057 /imagem -
Veo 3.1 Fast Google $0.170 /segundo -
Gemini Omni Google --