Veo 3.1
veo-3.1/text-to-video
Modelo de geração de vídeo do Google: a entrada de imagem gera nativamente vídeos de 8 segundos com som ambiente e diálogos, com suporte de até 4K e consistência na aparência do sujeito
Experimentar veo-3.1/text-to-video
Entrada
Criações
Ver todas as criaçõesSaída
videoPreços
veo-3.1/text-to-video per second
Apresentação
A rota de texto para vídeo do Veo 3.1 é voltada para desenvolvedores que precisam produzir um vídeo final diretamente a partir de uma frase de texto. Ele gera sob demanda vídeos de 4 a 8 segundos, em 720p a 4K, no formato horizontal ou vertical, com faixa de áudio nativa opcional, permitindo que sons ambientes, diálogos e efeitos sonoros do prompt sejam gerados em sincronia com a imagem. Você pode chamá-lo enviando o prompt pela interface unificada do HiAPI.ai, sendo adequado para anúncios curtos, conteúdo vertical para redes sociais e pré-visualização de storyboards, entre cenários que exigem validação rápida de ideias visuais.
Destaques
- Áudio e imagem nativos em sincronia, sem dublagem separada — com a geração de áudio ativada, o vídeo já traz sons ambientes, diálogos e efeitos sonoros, reduzindo as etapas de design e mixagem de áudio na pós-produção.
- Saída de até 4K em uma única geração — resolution aceita 720p, 1080p e 4k, atendendo desde a pré-visualização rápida até a entrega em alta qualidade.
- Alternância entre formatos horizontal e vertical sob demanda — aspect_ratio oferece suporte a 16:9 e 9:16, permitindo gerar diretamente a partir do mesmo prompt versões adaptadas a feeds ou plataformas verticais.
- Controle de saída com seed e prompt negativo — use seed para reproduzir resultados de geração e negative_prompt para excluir elementos indesejados, facilitando manter um estilo fixo na produção em lote.
Recursos
Vídeos curtos diretamente a partir de texto: insira um prompt descritivo (até 20.000 caracteres) e obtenha diretamente um clipe de 4, 6 ou 8 segundos, sem precisar preparar nenhum material.
Geração de faixa de áudio nativa: é possível gerar áudio nativo opcional; descreva no prompt sons ambientes, diálogos ou efeitos sonoros e o vídeo final já sai com som sincronizado, dispensando o processo de dublagem separado.
Controle de resolução e formato: a resolução de saída cobre 720p, 1080p e 4k, e o formato oferece suporte a 16:9 e 9:16, bastando escolher conforme o canal de veiculação.
Reprodutibilidade e restrições negativas: um seed fixo permite gerar repetidamente o mesmo resultado, e negative_prompt serve para excluir elementos de imagem indesejados, mantendo a consistência na produção em lote.
Cenários de uso
- Equipes de marketing produzindo anúncios curtos rapidamente — gere com um prompt de argumentos de venda do produto um vídeo curto de 8 segundos com áudio, usado diretamente na validação rápida de materiais de veiculação e na edição inicial.
- Operações de redes sociais criando vídeos verticais curtos — gere vídeos curtos em formato 9:16 para publicar em feeds ou plataformas de vídeo curto, dispensando o recorte de conteúdo horizontal.
- Pré-visualização de storyboards na pré-produção audiovisual — converta descrições de storyboard em clipes dinâmicos com efeitos sonoros, usados para visualização de conceitos e comunicação da equipe, reduzindo o custo de tentativa e erro antes da filmagem real.
- Pipelines de produção programática de conteúdo — desenvolvedores enviam prompts em lote pela interface unificada e integram os clipes gerados ao próprio sistema de gestão de conteúdo ou fluxo de trabalho automatizado.
Limitações e recomendações de escolha
O limite de duração por geração é de 8 segundos; conteúdos mais longos exigem várias gerações seguidas de montagem. Ativar o áudio ou aumentar a resolução eleva o custo por chamada, por isso recomenda-se escolher as especificações conforme os requisitos de veiculação. Esta rota é de texto para vídeo e não permite enviar imagens de referência para manter a consistência de aparência de pessoas ou produtos; para essa necessidade, deve-se usar a rota de imagem para vídeo da mesma família. Se houver exigência de continuidade entre múltiplos planos e narrativa longa, ainda será necessário planejamento manual adicional e gestão de consistência.
Perguntas frequentes
Ver todas as perguntas →-
Que tipo de modelo de vídeo é o Veo 3.1 Text to Video?
É uma linha puramente de texto para vídeo: basta um Prompt de texto, sem necessidade de enviar uma imagem inicial.
-
Quais especificações de saída o Veo 3.1 Text to Video suporta?
Suporta de 4 a 8 segundos, resoluções incluindo 720p, 1080p e 4k, e proporções de tela incluindo 16:9 e 9:16.
-
É possível gerar voz ou usar uma referência de áudio?
A geração de áudio está ativada por padrão
-
Como é cobrado o Veo 3.1 Text to Video?
A cobrança é feita pela duração da saída e pelo nível em tempo real; eventuais diferenças decorrentes de resolução, modo ou opções de áudio seguem os preços da página e o registro da tarefa.
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/text-to-video
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para veo-3.1/text-to-video e a rota default — veja a tabela de parâmetros abaixo.
seedintegerOpcionalSemente aleatória para tornar os resultados de geração reproduzíveis; use um número inteiro. A mesma semente combinada com a mesma entrada reproduz a mesma saída; quando não informada, é gerada aleatoriamente pelo sistema.
promptstringObrigatóriominLength 1maxLength 20000Prompt de texto que descreve o conteúdo do vídeo que se deseja gerar; use uma string.
durationintegerObrigatórioPadrão: 8min 4max 8Duração do clipe de vídeo, em segundos; o custo aumenta conforme a duração. Padrão de 8 segundos.
468resolutionstringObrigatórioPadrão: "720p"Resolução do vídeo de saída; quanto maior a resolução, maior o custo. Padrão 720p.
720p1080p4kaspect_ratiostringOpcionalPadrão: "16:9"Proporção de largura e altura do vídeo de saída. Padrão 16:9.
16:99:16generate_audiobooleanOpcionalPadrão: trueSe deve ser gerada uma faixa de áudio nativa para o vídeo; quando ativado, o preço é maior. Padrão true.
negative_promptstringOpcionalPrompt negativo que descreve o conteúdo a ser evitado no vídeo gerado; use uma string.
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": "veo-3.1/text-to-video",
"input": {
"prompt": "…",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}' 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/text-to-video",
input: {
"prompt": "…",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}),
});
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/text-to-video",
"input": {
"prompt": "…",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": True
}
},
)
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
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 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 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
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Veo 3.1 Google $0.290 /segundo -
Kling 4.0 Kuaishou $0.330 /segundo -
HeyGen Avatar V HeyGen $0.150 /segundo -
Hailuo 2.3 MiniMax $0.270 /vídeo -
LTX 2.5 Fast Lightricks $0.086 /segundo -
Seedance 2.0 ByteDance $0.017 /segundo -
HeyGen Avatar IV HeyGen $0.150 /segundo -
Kandinsky 6.0 Pro $1.93 /vídeo -
Kling 3.0 Turbo Kuaishou $0.130 /segundo -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Wan 3.0 Video Alibaba $0.040 /segundo -
HappyHorse 1.1 Alibaba $0.160 /segundo
Mesmo provedor
-
Nano Banana Pro Google $0.057 /imagem -
Veo 3.1 Lite Google $0.060 /segundo -
Veo 3.1 Google $0.290 /segundo -
Nano Banana 2 Google $0.036 /imagem -
Gemini Omni Google -- -
Gemini 3.1 Flash TTS Google -- -
Nano Banana Google $0.021 /imagem -
Nano Banana 2 Lite Google $0.033 /imagem -
Lyria 3 Pro Google $0.140 /música -
Veo 3.1 Fast Google $0.170 /segundo -
Google Virtual Try-On Google $0.107 /imagem -
Lyria 3.5 Google $0.090 /música