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.
", "aboutText": "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.\n\nConstrua 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.\n\nEscreva 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.\n\nNuma 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.\n\nO 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.\n\nO 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.\n\nO 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.\n\nUma 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.\n\nVeo 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.\n\nO 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.\n\nReveja 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f82945a95e5380d0481793904ad8a85dd31a677c2e1f1ffddb98f8159809092f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "google/veo-3.1-fastVeo 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.
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.
POST /v1/videostextvideo| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites google/veo-3.1-fast | Predefinição— |
Campoprompt | Tipostring | 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— |
Campoduration | Tipointeger | RequisitoObrigatório | Valores e limites 4, 6, 8 | Predefinição— |
Camporesolution | Tipostring | RequisitoObrigatório | Valores e limites 720p | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoObrigatório | Valores e limites 16:9, 9:16 | Predefinição— |
Campogenerate_audio | Tipoboolean | RequisitoObrigatório | Valores e limites false, true | Predefinição— |
Texto para vídeo · Obrigatório: prompt
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parâmetroadditional_properties | Contratofalse |
Parâmetroparameters | 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âmetromaterial_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.
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.
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 →
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.
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. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/veo-3.1-fast", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\nGuarde 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.
Consulte a tarefa original existente; nunca volte a enviar um pedido cujo envio tenha resultado desconhecido.
Número máximo de saídas: 4.
| Campo | Tipo | Significado |
|---|---|---|
Campoid | Tipostring | Significado— |
Campoobject | Tipostring | Significado— |
Campomodel | Tipostring | Significado— |
Campostatus | Tipostring | Significado— |
Campodata[] | Tiposigned content URL | Significado— |
Campocharge_pending_check | Tipoboolean | Significado— |
Campoerror.code | Tipostring | Significado— |
Campoerror.message | Tipostring | Significado— |
Campooperation_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. |
Campoerror.type | Tipostring | Significadoserver_error na resposta HTTP503 result_pending_check. |
| 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. |
Respostaserver_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. |
Ailoot Ultra google/veo-3.1-fast
/v1/videos/generations, /videos, /videos/generations