POST /flux/videos para concluir a geração de vídeo, geração de vídeo a partir de imagens de quadros-chave, extensão de vídeo e aprimoramento de rascunho. action=generate (padrão), mode seleciona o modo de geração; a consulta de resultados usa uniformemente o já existente POST /flux/tasks.
Atualmente em Beta. A geração de vídeo a partir de texto, geração de vídeo a partir de imagem, extensão de vídeo e aprimoramento de rascunho estão disponíveis. O HTTP 200 e o ID da tarefa apenas indicam que a tarefa foi aceita; é necessário continuar consultando o resultado final.
1. Obter o Token da API
- Registre-se ou faça login no Console Ace Data Cloud, crie uma aplicação e obtenha o Token da API. Um Token da API universal pode chamar os serviços da plataforma; confirme que a aplicação possui permissão para chamar o serviço Flux e saldo disponível.
- Consulte os planos e os preços de cada operação na página do serviço Flux. Quando o saldo for insuficiente, recarregue na página de saldo do console.
- As solicitações usam
Authorization: Bearer <seu Token>. O Token deve ser armazenado em variáveis de ambiente do servidor; não o inclua em páginas de frontend, repositórios públicos, capturas de tela ou URLs de callback.
O código deste documento lê uniformemente a variável de ambiente:
Para os campos completos e testes online, consulte Flux Videos API; para consulta de tarefas, consulte Flux Tasks API。
2. Selecionar a operação e a entrada
O modelo de geração é
flux-3, e action é generate (padrão). Selecione geração de vídeo a partir de texto, geração de vídeo a partir de imagem, extensão de vídeo ou aprimoramento de rascunho por meio de mode.
Parâmetros gerais de geração
As URLs dos materiais devem poder ser acessadas pelo serviço. Se usar URLs temporárias assinadas, reserve tempo de validade suficiente para o download e o processamento. Não use endereços de páginas web como endereços de arquivos de imagem ou vídeo.
3. Vídeo a partir de texto: solicitação completa testada e resultado
A solicitação a seguir foi executada com sucesso na interface de produção antes do ajuste de preço em 2026-10-02. A omissão deaction validou o comportamento de geração padrão; async=true evita aguardar por muito tempo a conexão HTTP.
task_id da sua própria resposta e continue consultando; não use o ID de tarefa do exemplo da documentação para consultar resultados de outras contas.
response retornado pela consulta de tarefa contém o resultado final do negócio. A seguir está o response obtido com sucesso neste teste, omitindo os metadados externos da tarefa. A URL do vídeo na documentação foi substituída por uma cópia do mesmo arquivo em uma CDN de exemplo de longa duração (SHA-256 idêntico); a chamada real retornará a URL de resultado própria desta tarefa:
Este é um teste histórico de antes do ajuste de preço:
list_amount=2.9871876975 Credits, a conta tinha na época um desconto de consumo de 10%, e o amount real foi de 2.68846892775 Credits. O novo preço em 2026-10-02 foi reduzido em aproximadamente 6,33%; o mesmo rascunho de 5,041667 segundos, ao preço atual, custa 2.798125185 Credits (antes do desconto de consumo), ou 2.5183126665 Credits se ainda houver um desconto de consumo de 10%. As faturas de tarefas históricas não são recalculadas. Os planos e descontos de outras contas podem ser diferentes; este não é um preço fixo em dólares para todos os usuários.
4. Imagem para vídeo: normal e com quadros-chave temporizados
A seguir estão exemplos de parâmetros; é necessário substituir as URLs dos materiais, e isto não é uma declaração de que o exemplo já foi executado com sucesso. Após a geração ser concluída, consulte seguindo o processo acima; a estrutura do resultado é a mesma. Para uma ou duas imagens, use um array normal:[segundos, URL da imagem]:
Saída testada de imagem para vídeo
A entrada correspondente deste teste é a seguinte (somente o texto explicativo substitui o base64 completo; os demais campos são solicitações reais):
Após baixar este quadro-chave PNG, é possível usar base64.b64encode(image_bytes).decode("ascii") do Python para obter a string original e colocá-la no array keyframes. Não use o texto explicativo no documento como entrada de imagem.
A seguir está a response final real de uma tarefa de produção de 2026-10-01 (não uma resposta simulada); somente a URL do vídeo foi substituída por uma cópia de exemplo de longo prazo com o mesmo hash. A entrada testada usou a string base64 original de um PNG de 1280×720 como quadro-chave único; a entrada de URL acima é um exemplo de parâmetro independente.
5. Continuação de vídeo
start_video recebe o endereço de um arquivo de vídeo existente, mode=v2v, com duração máxima de 15 segundos.
Saída de teste da continuação de vídeo
A entrada completa deste teste é a seguinte; ao reproduzir o aprimoramento de rascunho, substitua pelo seu próprio ID de rascunho. A URL do material usa uma cópia de exemplo de longo prazo do mesmo arquivo:start_video de entrada do teste é o vídeo de rascunho concluído, e os demais parâmetros são duration=5, resolution=hd, generate_audio=false.
6. Primeiro rascunho, depois aprimoramento
- Use
draft=true,resolution=hdpara gerar um rascunho e aguarde a conclusão bem-sucedida. - Obtenha o ID de rascunho da plataforma a partir de
data[0].draft_task_idfinal. - Use as credenciais do aplicativo da mesma propriedade para enviar a solicitação de aprimoramento:
prompt, duration, aspect_ratio, version, generate_audio, draft, keyframes, start_video para substituir o conteúdo original. O cache de rascunho é um recurso temporário; faça o aprimoramento em tempo hábil; não há garantia de armazenamento permanente ou de um número fixo de dias de retenção. Rascunhos que não sejam seus/não sejam do aplicativo atual, rascunhos não concluídos e caches expirados não podem ser reutilizados. O rascunho e o aprimoramento são duas tarefas, e são cobrados separadamente após serem concluídos com sucesso.
Saída de teste do aprimoramento de rascunho
A entrada completa deste teste é a seguinte; ao reproduzir o aprimoramento de rascunho, substitua pelo seu próprio ID de rascunho. A URL do material usa uma cópia de exemplo de longo prazo do mesmo arquivo:7. Chamada Python de ponta a ponta
Instalerequests, configure o seu próprio Token e execute o script abaixo para concluir “enviar uma vez → consultar periodicamente → gerar a URL do vídeo”. Tanto as consultas quanto as tentativas de repetição de rede devem usar o task_id original, para evitar o reenvio de tarefas pagas.
task_id já tiver sido obtido, continue consultando essa tarefa; registre task_id e trace_id para facilitar a investigação. A própria interface de consulta não cobra taxas de geração.
8. Uso de callback
Adicionecallback_url ao enviar; após a conclusão da tarefa, será feito POST do resultado JSON final para esse endereço. A estrutura de sucesso é consistente com o response mencionado anteriormente; em caso de falha, inclui error.
9. Cobrança atual e tabela de preços
Atualizado em 2026-10-02: os preços unitários de cada faixa desta interface de vídeo foram reduzidos em aproximadamente 6,33%; o método de medição, os pacotes e as regras de desconto por consumo permanecem inalterados. O cost nos responses de medições históricas mencionados anteriormente é a cobrança no momento da conclusão da tarefa e não representa a cotação atual. A geração de vídeo é cobrada por segundos reais de saída. Abaixo estão os preços unitários atuais em Credits sem a aplicação de descontos por consumo da conta, consistentes com as regras da página de preços do Flux.
Conversão para dólares americanos:
custo real（USD）= cost.amount（Credits）× preço do pacote / amount do pacote. As faixas de recarga e os descontos por consumo afetam o preço real; Credits não podem ser tratados diretamente como USD. Tarefas com falha não cobram taxas de geração; o valor final prevalece conforme o resultado concluído e os registros de chamadas no console.
10. Perguntas frequentes e solução de problemas
Ao fornecer feedback, inclua task_id, trace_id, horário da solicitação e parâmetros mascarados; não envie o API Token. Para mais formas, consulte o guia de integração Flux MCP.