Google: Veo 3.1 Fast

Veo 3.1 Fast é o modelo de vídeo da Google para cenas curtas orientadas por texto ou imagem com som gerado. O seu perfil de produção devolve clipes MP4 de quatro, seis ou oito segundos a 24 fps, com saída a 720p ou 1080p e fotogramas iniciais ou finais guiados.

Ailoot Ultra · Vídeo POST /v1/videos google/veo-3.1-fast

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

Veo 3.1 Fast é o perfil rápido de geração de vídeo da Google para uma cena curta descrita em texto ou estabelecida por uma imagem. Combina o plano visual com som gerado e suporta fotogramas inicial e final guiados. Utilize-o para desenvolver um conceito de cena, preparar variações criativas curtas ou fazer um segmento audiovisual compacto com uma ação e uma direção visual claras.

Construa as instruções em torno do sujeito, da ação e do cenário. Acrescente depois o enquadramento, o movimento da câmara, a iluminação e o tratamento visual que tornam o plano útil. Uma instrução original de produto pode mostrar um pequeno candeeiro de cerâmica numa secretária de madeira, com a câmara a aproximar-se lentamente enquanto a luz se acende e um som discreto de interruptor acompanha a ação. O sujeito e o acontecimento visível descrevem a imagem; a orientação sonora descreve a experiência de escuta.

Escreva a direção da cena em inglês, como especificado pelo perfil de instruções do produtor. Mantenha a ação principal proporcional à duração do clipe e distinga um movimento de câmara de um movimento do sujeito. Uma vista ampla de apresentação, um grande plano de uma textura e um plano a acompanhar um objeto em movimento respondem a questões criativas diferentes. Escolha a vista que comunica o pormenor pretendido, em vez de combinar orientações de câmara sem relação entre si num único plano curto.

Numa cena orientada por imagem, prepare uma imagem inicial nítida que já estabeleça o aspeto e a composição. As instruções de movimento podem depois concentrar-se no acontecimento seguinte. Um fotograma final pode fornecer um destino visual para a transição. Mantenha coerentes entre os fotogramas os pormenores importantes do sujeito e o estilo ou descreva explicitamente a transformação pretendida. Reveja a própria transição, bem como a imagem inicial e final.

O perfil de produção do fabricante suporta clipes de quatro, seis ou oito segundos, enquadramento horizontal 16:9 ou vertical 9:16 e até quatro vídeos de saída por instrução. A saída Fast é a 720p ou 1080p, a 24 fotogramas por segundo, em formato MP4. O perfil orientado por imagem aceita JPEG ou PNG, indica um tamanho máximo de imagem de entrada de 20 MB e suporta configurações de entrada a 720p/1080p. Prepare a composição para a orientação pretendida e mantenha a entrada dentro desse limite de imagem.

O som pode fazer parte da cena gerada. Descreva qualquer fala, som ambiental ou efeito relevante com a ação visível, identificando o sujeito que deve falar e o acontecimento que deve produzir o som. Mantenha o diálogo suficientemente curto para a interpretação pretendida e distinga-o da atmosfera ou da música. A geração de áudio segue as instruções escritas da cena; uma gravação de áudio não está entre as entradas normais documentadas deste perfil.

O perfil atual de produção apresenta também geração com referências de recursos e extensão de vídeo. As referências orientam o aspeto de um sujeito ou objeto, enquanto os fotogramas de início e fim orientam a composição inicial e final. Selecione material de referência cujo papel seja claro na cena, em vez de tratar todas as imagens como controlos intercambiáveis. Para continuar um clipe, escolha o fluxo separado de extensão e descreva o que deve acontecer depois da ação existente; o seu tratamento das entradas é distinto de um novo plano orientado por texto.

Uma descrição negativa pode identificar conteúdo ou tratamentos visuais que pretende evitar. Mantenha a instrução principal focada na cena que pretende e torne as exclusões específicas para a tarefa. Numa variação de produto, preserve o sujeito e o enquadramento, alterando um pormenor, como a direção da luz ou o tratamento de material. Conserve as definições e o conjunto de referências ao comparar resultados, para que a diferença criativa permaneça clara.

Veo 3.1 Fast e o perfil normal Veo 3.1 mantêm-se escolhas distintas. A saída documentada de produção Fast é a 720p/1080p; o perfil normal apresenta também 4K. Mantenha a edição selecionada e as suas definições de saída com o recurso, em vez de tratar um identificador Preview ou outra versão Veo como sinónimo automático deste perfil de produção.

O fluxo cria uma operação de geração e disponibiliza os ficheiros de vídeo devolvidos após a conclusão. Guarde todas as saídas efetivas selecionadas para revisão, juntamente com as suas instruções, fotogramas de origem e definições relevantes. Um identificador de operação é um registo da geração; o recurso MP4 concluído é o que pode ser reproduzido e utilizado na montagem. Preserve quaisquer metadados de proveniência de conteúdo fornecidos com o vídeo.

Reveja o aspeto do sujeito, a ação pedida, o tratamento da câmara e o som ao longo de todo o clipe. Verifique a inteligibilidade do diálogo e a relação entre o som e os acontecimentos visíveis antes de o utilizar numa composição mais longa. O resultado útil pode ser um plano de conceito, uma revelação de produto ou um segmento narrativo curto, com títulos, transições e outros elementos de montagem posteriores acrescentados no fluxo de produção envolvente.

Ailoot Ultra · Vídeo POST /v1/videos google/veo-3.1-fast

google/veo-3.1-fast

Google /google/veo-3.1-fast

Introdução

Entradas aceites: Texto
Resultados: Vídeo

Disponível no Ailoot · entradas e métodos

Ailoot Ultra · Vídeo POST /v1/videos

Entrada: text
Saída: video
Formato de saída: mp4
Número de saídas: Até 4 saídas

Campo	Tipo	Requisito	Valores e limites	Predefinição
Campo`model`	Tipo`string`	RequisitoObrigatório	Valores e limites google/veo-3.1-fast	Predefinição—
Campo`prompt`	Tipo`string`	RequisitoObrigatório	Valores e limites Número máximo de bytes UTF-8: 10 000 São obrigatórios caracteres que não sejam espaços: Sim	Predefinição—
Campo`duration`	Tipo`integer`	RequisitoObrigatório	Valores e limites 4, 6, 8	Predefinição—
Campo`resolution`	Tipo`string`	RequisitoObrigatório	Valores e limites 720p	Predefinição—
Campo`aspect_ratio`	Tipo`string`	RequisitoObrigatório	Valores e limites 16:9, 9:16	Predefinição—
Campo`generate_audio`	Tipo`boolean`	RequisitoObrigatório	Valores e limites false, true	Predefinição—

Combinações de materiais de entrada

Texto para vídeo · Obrigatório: prompt

Parâmetros e ciclo de vida do método

Parâmetro	Contrato
Parâmetro`content_type`	Contratoapplication/json
Parâmetro`required`	Contratomodel, prompt, duration, resolution, aspect_ratio, generate_audio
Parâmetro`additional_properties`	Contratofalse
Parâmetro`parameters`	Contrato{"name":"model","type":"string","required":true,"enum":["google/veo-3.1-fast"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]}
Parâmetro`material_types`	Contratotext

Aliases do método: /v1/videos/generations, /videos, /videos/generations

Ciclo de vida: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Conserve a resposta completa e os IDs originais devolvidos.

Nunca volte a enviar uma criação de resultado desconhecido.

Tarifários

Cálculo do custo final

As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.

As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.

Modo rápido: Não especificado Quando o modo rápido está selecionado
Modo flex: Não especificado Quando o modo flex está selecionado
Esforço máximo de raciocínio: Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)

Tarifas estimadas para comparação

Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

Configuração	Tabela de tarifas	Quantidade prevista	Gerar áudio	Resolução	Unidade de faturação	Condições de faturação	Custo
ConfiguraçãoTarifas base por token	Tabela de tarifasTarifa base	Quantidade prevista—	Gerar áudio—	Resolução—	Unidade de faturação—	Condições de faturação—	Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens
ConfiguraçãoPreço do vídeo	Tabela de tarifas—	Quantidade prevista—	Gerar áudio—	Resolução—	Unidade de faturaçãopor segundo de vídeo	Condições de faturaçãoáudio: with_audio	Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.24 por segundo de vídeo
ConfiguraçãoPreço do vídeo	Tabela de tarifas—	Quantidade prevista—	Gerar áudio—	Resolução—	Unidade de faturaçãopor segundo de vídeo	Condições de faturaçãoáudio: with_audio; resolução: 4k	Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.6 por segundo de vídeo
ConfiguraçãoUltra	Tabela de tarifas—	Quantidade previstaConfiguração solicitada; apenas uma estimativa.	Gerar áudioCom áudio	Resolução720p	Unidade de faturaçãopor segundo de vídeo de saída	Condições de faturação—	Custo Saída · Segundo estimado de vídeo de saída · Estimativa apenas para comparação $0.2 por segundo de vídeo de saída A tarifa apresentada estima o custo antes da geração. O custo final é calculado a partir do custo registado para a geração original. A duração física do vídeo não é a quantidade faturável.
ConfiguraçãoPreço do vídeo	Tabela de tarifas—	Quantidade prevista—	Gerar áudio—	Resolução—	Unidade de faturaçãopor segundo de vídeo	Condições de faturaçãoáudio: without_audio	Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.2 por segundo de vídeo
ConfiguraçãoPreço do vídeo	Tabela de tarifas—	Quantidade prevista—	Gerar áudio—	Resolução—	Unidade de faturaçãopor segundo de vídeo	Condições de faturaçãoáudio: without_audio; resolução: 4k	Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.5 por segundo de vídeo
ConfiguraçãoUltra	Tabela de tarifas—	Quantidade previstaConfiguração solicitada; apenas uma estimativa.	Gerar áudioSem áudio	Resolução720p	Unidade de faturaçãopor segundo de vídeo de saída	Condições de faturação—	Custo Saída · Segundo estimado de vídeo de saída · Estimativa apenas para comparação $0.16 por segundo de vídeo de saída A tarifa apresentada estima o custo antes da geração. A cobrança final é calculada a partir do custo registado para a geração original. A duração física do vídeo não é a quantidade faturável.
ConfiguraçãoCusto estimado de geração	Tabela de tarifas—	Quantidade previstaestimativa para uma geração	Gerar áudio—	Resolução—	Unidade de faturação—	Condições de faturação—	Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.64 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída.

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →

Detalhes da tarifa de referência

As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.

Referências de preços das configurações de vídeo

Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

Configuração	Condições de faturação	Custo
ConfiguraçãoPreço do vídeo	Condições de faturaçãoáudio: with_audio	Custo Saída · Preço do vídeo $0.24 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.
ConfiguraçãoPreço do vídeo	Condições de faturaçãoáudio: with_audio; resolução: 4k	Custo Saída · Preço do vídeo $0.6 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.
ConfiguraçãoPreço do vídeo	Condições de faturaçãoáudio: without_audio	Custo Saída · Preço do vídeo $0.2 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.
ConfiguraçãoPreço do vídeo	Condições de faturaçãoáudio: with_audio; resolução: 720p	Custo Saída · Preço do vídeo $0.2 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.
ConfiguraçãoPreço do vídeo	Condições de faturaçãoáudio: without_audio; resolução: 4k	Custo Saída · Preço do vídeo $0.5 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.
ConfiguraçãoPreço do vídeo	Condições de faturaçãoáudio: without_audio; resolução: 720p	Custo Saída · Preço do vídeo $0.16 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada.

Exemplos de pedidos

Ailoot Ultra · Vídeo

curl · perfil exatamente como configurado

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1-fast", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Receber e guardar os resultados

Ailoot Ultra · Vídeo

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Verificar o estado da tarefa

GET estado da operação original

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Outras leituras de conteúdo

Guardar cada saída concluída de que é titular

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Conserve todos os URL assinados de data[] concluído pertencentes ao utilizador e todos os metadados do estado. Guarde todas as saídas, incluindo o áudio gerado. Pode existir uma faixa de áudio AAC válida mesmo com generate_audio=false; conserve o MP4 original completo, incluindo esse áudio.

Se for necessário verificar a resposta original

Consulte a tarefa original existente; nunca volte a enviar um pedido cujo envio tenha resultado desconhecido.

Número máximo de saídas: 4.

Campos da resposta

Campo	Tipo	Significado
Campo`id`	Tipostring	Significado—
Campo`object`	Tipostring	Significado—
Campo`model`	Tipostring	Significado—
Campo`status`	Tipostring	Significado—
Campo`data[]`	Tiposigned content URL	Significado—
Campo`charge_pending_check`	Tipoboolean	Significado—
Campo`error.code`	Tipostring	Significado—
Campo`error.message`	Tipostring	Significado—
Campo`operation_id`	Tipostring	SignificadoResposta HTTP503 result_pending_check do estado/conteúdo original: o mesmo ID público da operação de vídeo original como id.
Campo`error.type`	Tipostring	Significadoserver_error na resposta HTTP503 result_pending_check.

Erros e passos seguintes

Resposta	Condição	Passo seguinte
Resposta400 · `invalid_request_error`	CondiçãoA leitura do corpo bruto do pedido falha antes da análise do perfil de vídeo	Passo seguinteConserve a resposta devolvida e corrija o corpo ilegível do pedido.
Resposta422 · `price_unavailable`	CondiçãoA análise do perfil exato de vídeo falha ou o perfil completo analisado não tem uma ficha exata de preços pronta	Passo seguinteConserve a resposta; utilize o perfil completo e exato autorizado e a respetiva ficha publicada. Este ramo é executado antes de qualquer envio ao fornecedor.
Resposta409 · `video_not_ready`	CondiçãoO conteúdo do resultado original ainda não está disponível	Passo seguinteConsulte periodicamente o ID original devolvido e respeite Retry-After.
Resposta`server_error`	CondiçãoA resposta devolvida indica que a operação ou o resultado requer verificação	Passo seguinteGuarde o ID original da operação/tarefa devolvido, os cabeçalhos do pedido e a resposta; continue a consultar essa operação original através das consultas suportadas. Não volte a enviar o pedido de criação.
Resposta503 · `result_pending_check`	CondiçãoGET do estado/conteúdo original: a tarefa não está publicada, a tarefa original não está failed/cancelled/expired e o estado local é unknown ou o estado da tarefa original é completed.	Passo seguinteConserve id e operation_id originais (o mesmo ID público de vídeo), a resposta e os cabeçalhos; consulte apenas o estado/conteúdo original. Nunca envie um novo pedido de geração.

Aliases

Aliases do modelo

Ailoot Ultra google/veo-3.1-fast

Aliases dos caminhos dos métodos

/v1/videos/generations, /videos, /videos/generations

IDs de chamada relacionados

google/veo-3.1-fast

FAQ · Google: Veo 3.1 Fast

Que entradas e resultados estão disponíveis?: POST /v1/videos · google/veo-3.1-fast: text → video
Que campos utiliza o pedido?: POST /v1/videos · google/veo-3.1-fast: model, prompt, duration, resolution, aspect_ratio, generate_audio

Google: Veo 3.1 Fast