Skip to main content
Com a aplicação da IA se expandindo, diversos programas de IA têm se tornado cada vez mais comuns. A IA tem se infiltrado em todos os aspectos da vida e do trabalho das pessoas. E os setores envolvidos com a IA estão se multiplicando, desde a escrita inicial, passando pela educação médica, até agora, os vídeos. Luma é uma plataforma profissional de geração de vídeos de alta qualidade, onde os usuários podem simplesmente fazer o upload de materiais e gerar automaticamente vídeos de alta qualidade com base em diferentes estilos e efeitos. Este gerador de vídeo AI foi desenvolvido por membros de uma equipe de uma conhecida empresa de tecnologia, com o objetivo de permitir que todos possam facilmente criar vídeos impressionantes, sem a necessidade de ferramentas de edição complexas. No entanto, a Luma oficialmente não fornece uma API, a AceDataCloud oferece um conjunto de APIs da Luma, simulando a integração com a oficial da Suno, permitindo gerar vídeos desejados de forma rápida e conveniente.

​
Solicitação e Uso

Para usar a API de Geração de Vídeos da Luma, primeiro acesse o Painel de Controle da Ace Data Cloud para obter seu Token de API, que deve ser guardado para uso futuro. Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e fazer login. Após a conclusão, você será redirecionado de volta para a página atual. Um Token de API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar um para cada serviço individualmente. A primeira solicitação oferece um crédito gratuito, permitindo uma experiência sem custo; quando o crédito estiver baixo, você pode recarregar o saldo geral no painel de controle.
📘 Documentação Completa: API de Geração de Vídeos da Luma →

​
Uso Básico

Para gerar um vídeo, você pode inserir qualquer texto, por exemplo, se eu quiser gerar um vídeo sobre astronautas se deslocando entre o espaço e um vulcão, posso inserir Astronauts shuttle from space to volcano, como mostrado na imagem:

O código gerado é o seguinte:

Principais parâmetros de solicitação:
  • prompt: palavra-chave para gerar o vídeo.
  • aspect_ratio: proporção largura-altura do vídeo, padrão 16:9.
  • end_image_url: opcional, especifica o quadro final.
  • enhancement: opcional, interruptor de aumento de clareza.
  • loop: se deve gerar um vídeo em loop, padrão false.
  • timeout: opcional, número de segundos para timeout.
  • callback_url: endereço de callback assíncrono.
  • async: opcional, se definido como true, a interface retorna imediatamente task_id, sem necessidade de fornecer callback_url, e em seguida, você pode consultar o resultado através da interface de consulta de tarefas correspondente.
Você pode clicar no botão “Try” para testar a API diretamente, aguarde 1-2 minutos, e o resultado será o seguinte:
Podemos ver que neste momento obtivemos as informações relacionadas a este vídeo, incluindo ID do vídeo, link do vídeo, capa do vídeo, entre outros. A descrição dos campos é a seguinte:
  • success: se a geração foi bem-sucedida, se sim, será true, caso contrário, false
  • task_id: ID único da tarefa de geração de vídeo
  • video_id: ID único do vídeo gerado pela tarefa de geração de vídeo
  • prompt: palavra-chave da tarefa de geração de vídeo
  • video_url: link do vídeo resultante da tarefa de geração de vídeo
  • video_height: altura da imagem da capa do vídeo gerado
  • video_width: largura da imagem da capa do vídeo gerado
  • state: estado da tarefa de geração de vídeo, se a tarefa estiver concluída, será completed.
  • thumbnail_url: link da imagem da capa do vídeo gerado
  • thumbnail_width: largura da imagem da capa do vídeo gerado
  • thumbnail_height: altura da imagem da capa do vídeo gerado

​
Geração de Quadros Personalizados

Se você deseja gerar um vídeo através de quadros personalizados, pode inserir os links das imagens dos quadros inicial e final: Neste caso, o campo start_image_url pode receber a seguinte imagem como o quadro inicial do vídeo: Quadro Inicial Em seguida, para personalizar a geração do vídeo com base nos quadros inicial e final, você pode especificar o seguinte conteúdo:
  • action: ação da tarefa de geração de vídeo, geralmente é geração normal generate e geração estendida extend, padrão é generate.
  • start_image_url: especifica o quadro inicial do vídeo gerado.
  • end_image_url: especifica o quadro final do vídeo gerado.
  • prompt: conteúdo da palavra-chave para gerar o vídeo.
Um exemplo de preenchimento é o seguinte:

Após o preenchimento, o código gerado é o seguinte:

O código correspondente:
O resultado obtido é o seguinte:
O resultado final é semelhante ao anterior, o quadro inicial do vídeo gerado contém a imagem que inserimos, e também é possível inserir links de imagens para os quadros inicial e final para gerar o vídeo, basta adicionar uma imagem para o quadro final com base no que foi mencionado acima, as informações da imagem do quadro final são as seguintes: Quadro Final Um exemplo de preenchimento é o seguinte:

最后得出如下结果：
O resultado é semelhante ao anterior, o vídeo gerado contém imagens do primeiro e do último quadro, completando assim a personalização do primeiro e do último quadro para gerar o vídeo.

​
Funcionalidade de Extensão de Vídeo

Se você deseja continuar gerando o vídeo gerado, pode definir o parâmetro action como extend e inserir o ID do vídeo ou o link do vídeo que precisa ser continuado. O ID do vídeo e o link do vídeo podem ser obtidos com base no uso básico, conforme mostrado na imagem abaixo:

Neste momento, você pode ver que o ID do vídeo é:
Nota: Aqui, o video_id e o video_url do vídeo são o ID e o link do vídeo gerado. Se você não souber como gerar um vídeo, pode consultar o uso básico mencionado acima para gerar o vídeo.
Para continuar gerando o vídeo, é necessário enviar o link do vídeo ou o ID do vídeo. Abaixo, demonstramos como usar o ID do vídeo para extensão. Em seguida, devemos preencher as palavras-chave para personalizar a geração do vídeo, podendo especificar o seguinte conteúdo:
  • action: neste caso, a ação de extensão do vídeo, que deve ser extend.
  • prompt: as palavras-chave para a extensão do vídeo.
  • video_url: o link do vídeo que precisa ser estendido.
  • video_id: o ID único do vídeo que precisa ser estendido.
  • end_image_url: o link da imagem do quadro final que pode ser especificado, parâmetro opcional.
O exemplo de preenchimento é o seguinte:

Após o preenchimento, o código gerado automaticamente é o seguinte:

Código correspondente em Python:
Ao clicar em executar, você pode notar que um resultado é obtido, conforme abaixo:
Pode-se ver que o vídeo foi estendido com base no vídeo que precisava ser estendido, e o conteúdo do resultado é consistente com o anterior, realizando assim a funcionalidade de continuação da geração da música. Claro, também podemos especificar o link do vídeo para realizar a extensão, preenchendo as seguintes informações:

Após a execução, obtemos o seguinte resultado:
De acordo com o resultado, pode-se ver que a funcionalidade de extensão do vídeo também pode ser realizada com base no link do vídeo. Por fim, também podemos especificar uma imagem de quadro final para a extensão do vídeo. Abaixo estão as informações da imagem do quadro final: Quadro Final Em seguida, adicionamos as informações da imagem do quadro final com base no que foi mencionado acima, conforme mostrado abaixo:

Ao clicar em executar, obtemos as seguintes informações:
Pode-se ver que, com base na extensão do vídeo anterior, também é possível especificar uma imagem de quadro final para a extensão.

​
Callback Assíncrono

Como o tempo para gerar vídeos com Luma é relativamente longo, cerca de 1 a 2 minutos, se a API não responder por um longo período, a solicitação HTTP manterá a conexão, resultando em um consumo adicional de recursos do sistema. Portanto, esta API também oferece suporte a callbacks assíncronos. 整体流程是：o cliente inicia a solicitação, especificando um campo adicional callback_url. Após o cliente fazer a solicitação da API, a API retornará imediatamente um resultado, contendo um campo de informação task_id, que representa o ID da tarefa atual. Quando a tarefa for concluída, o resultado da música será enviado ao callback_url especificado pelo cliente no formato POST JSON, que também incluirá o campo task_id, assim o resultado da tarefa pode ser associado pelo ID. Abaixo, vamos entender como operar isso através de um exemplo. Primeiro, o callback Webhook é um serviço que pode receber solicitações HTTP, e os desenvolvedores devem substituir pela URL do servidor HTTP que construíram. Aqui, para facilitar a demonstração, usamos um site de exemplo de Webhook público https://webhook.site/, ao abrir este site, você obterá uma URL de Webhook, como mostrado na imagem:

Copie esta URL, que pode ser usada como Webhook, o exemplo aqui é https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13. Em seguida, podemos definir o campo callback_url para a URL do Webhook acima, enquanto preenchemos prompt, como mostrado na imagem:

Clique em executar, e você verá que receberá imediatamente um resultado, como abaixo:
Após alguns instantes, podemos observar o resultado da música gerada em https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13, como mostrado na imagem: O conteúdo é o seguinte:
Pode-se ver que o resultado contém um campo task_id, e os outros campos são semelhantes aos mencionados acima, através deste campo é possível realizar a associação da tarefa.