Saltar para o conteúdo principal
Com a ampla aplicação da IA, vários tipos de programas de IA têm se popularizado gradualmente. A IA tem se aprofundado gradualmente em todos os aspectos do trabalho e da vida das pessoas. E os setores envolvidos pela IA também estão se tornando cada vez mais numerosos, desde a escrita inicial, passando pela educação médica, até os vídeos atuais. Luma é uma plataforma profissional de geração de vídeos de alta qualidade. Os usuários só precisam enviar materiais para gerar automaticamente vídeos de alta qualidade com base em diferentes estilos e efeitos. Este gerador de vídeos por IA foi desenvolvido por membros de equipes de empresas de tecnologia renomadas, com o objetivo de permitir que todos criem vídeos excelentes facilmente, sem ferramentas de edição complexas. No entanto, a Luma oficialmente não fornece uma API. A AceDataCloud fornece um conjunto de APIs da Luma, simulando a integração oficial da Suno, permitindo gerar de forma conveniente e rápida os vídeos desejados.

​
Solicitação e uso

Para usar a API de Geração de Vídeos Luma, primeiro obtenha seu Token de API no console do Ace Data Cloud e guarde-o para uso posterior. Se você ainda não estiver conectado ou registrado, será redirecionado automaticamente para a página de login para se registrar e entrar. Após concluir, você retornará automaticamente a esta página. Um único Token de API pode chamar todos os serviços da plataforma, sem necessidade de solicitar separadamente para cada serviço. A primeira solicitação oferece créditos gratuitos para uma experiência gratuita; quando os créditos forem insuficientes, é possível recarregar o saldo universal no console.
📘 Documentação completa: API de Geração de Vídeos Luma →

​
Uso básico

Para gerar qualquer vídeo desejado, você pode inserir livremente um trecho de texto. Por exemplo, se eu quiser gerar um vídeo sobre astronautas viajando entre o espaço e vulcões, posso inserir Astronauts shuttle from space to volcano, conforme mostrado na imagem:

O código gerado é o seguinte:

Principais parâmetros de solicitação:
  • prompt: Texto de instrução para gerar o vídeo.
  • aspect_ratio: Proporção de aspecto do vídeo, o padrão é 16:9.
  • end_image_url: Opcional, especifica o quadro final.
  • enhancement: Opcional, interruptor de aprimoramento de nitidez.
  • loop: Se deve gerar um vídeo em loop, o padrão é false.
  • timeout: Opcional, número de segundos de tempo limite.
  • callback_url: Endereço de callback assíncrono.
  • async: Opcional, quando definido como true, a interface retorna imediatamente o task_id, sem necessidade de fornecer callback_url; em seguida, obtenha o resultado por polling através da interface de consulta de tarefa correspondente.
Você pode clicar diretamente no botão «Try» para testar a API. Aguarde 1-2 minutos, e o resultado será o seguinte:
Pode-se 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 e outros conteúdos. A descrição dos campos é a seguinte:
  • success: Se a geração foi bem-sucedida; se foi bem-sucedida, será true, caso contrário será false
  • task_id: O ID único da tarefa de geração de vídeo aqui
  • video_id: O ID único do vídeo gerado pela tarefa de geração de vídeo aqui
  • prompt: As palavras-chave da tarefa de geração de vídeo aqui
  • video_url: O link do vídeo resultante da tarefa de geração de vídeo aqui
  • video_height: A altura da imagem de capa do vídeo gerada
  • video_width: A largura da imagem de capa do vídeo gerada
  • state: O status da tarefa de geração de vídeo aqui; se a tarefa for concluída, será completed.
  • thumbnail_url: O link da imagem de capa do vídeo gerada
  • thumbnail_width: A largura da imagem de capa do vídeo gerada
  • thumbnail_height: A altura da imagem de capa do vídeo gerada

​
Geração personalizada com quadros inicial e final

Se desejar gerar um vídeo personalizando os quadros inicial e final do vídeo, você pode inserir os links das imagens dos quadros inicial e final: Neste momento, o campo start_image_url do quadro inicial do vídeo pode receber a seguinte imagem como quadro inicial do vídeo: Quadro inicial Em seguida, para gerar um vídeo personalizado com base nos quadros inicial e final e nas palavras-chave, é possível especificar o seguinte conteúdo:
  • action: A ação da tarefa de geração de vídeo, geralmente geração normal generate e geração de extensão extend, o padrão é generate.
  • start_image_url: Especifica o quadro inicial do vídeo a ser gerado.
  • end_image_url: Especifica o quadro final do vídeo a ser gerado.
  • prompt: O conteúdo de palavras-chave para gerar o vídeo.
O exemplo de preenchimento é o seguinte:

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

O código correspondente:
O resultado obtido é o seguinte:
O resultado final obtido é semelhante ao descrito acima: o quadro inicial do vídeo gerado contém a imagem que enviamos. Naturalmente, também é possível enviar simultaneamente os links das imagens dos quadros inicial e final para gerar o vídeo; basta adicionar uma imagem de quadro final com base no conteúdo acima. As informações da imagem do quadro final são as seguintes: Quadro final O exemplo de preenchimento é o seguinte:

Por fim, obtém-se o seguinte resultado:
O resultado é semelhante ao acima, o vídeo gerado contém simultaneamente as imagens do primeiro e do último quadro, o que conclui a geração de vídeo com quadros inicial e final personalizados.

​
Funcionalidade de extensão de vídeo

Se quiser continuar gerando o vídeo gerado, você pode definir o parâmetro action como extend e inserir o ID ou o link do vídeo que precisa continuar sendo gerado. A obtenção do ID e do link do vídeo é feita com base no uso básico, conforme mostrado na imagem abaixo:

Neste momento, é possível ver que o ID do vídeo é:
Observe que video_id e video_url no vídeo aqui 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 acima para gerar um vídeo.
Para continuar gerando o vídeo, é necessário enviar o link ou o ID do vídeo. Abaixo é demonstrado o uso do ID do vídeo para extensão. Em seguida, devemos preencher palavras-chave para personalizar a geração do vídeo, podendo especificar o seguinte conteúdo:
  • action: o comportamento de extensão do vídeo neste momento, que aqui deve ser extend.
  • prompt: as palavras-chave do vídeo que precisa ser estendido.
  • video_url: o link do vídeo que precisa ser gerado por extensão.
  • video_id: o ID único do vídeo que precisa ser gerado por extensão.
  • end_image_url: o link da imagem que pode especificar o quadro final do vídeo gerado por extensão, parâmetro opcional.
O exemplo de preenchimento é o seguinte:

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

O código Python correspondente:
Clique em executar e você verá que obterá um resultado, conforme abaixo:
Pode-se ver que este vídeo é estendido com base no vídeo que precisa ser estendido, e o conteúdo do resultado é consistente com o acima, o que também implementa a funcionalidade de continuar gerando a música. Naturalmente, também podemos especificar o link do vídeo para realizar a geração por extensão, preenchendo as seguintes informações:

Após executar, obteve-se o seguinte resultado:
Pode-se ver pelo resultado que a funcionalidade de extensão de vídeo também pode ser implementada com base no link do vídeo. Por fim, também podemos especificar uma imagem de quadro final no vídeo de extensão para realizar a extensão. Abaixo estão as informações da imagem do quadro final: Quadro final Em seguida, adicione as informações da imagem do quadro final com base no acima, especificamente como mostrado abaixo:

Após clicar em executar, obtém-se as seguintes informações:
Pode-se ver que, com base no vídeo estendido acima, também é possível especificar uma imagem de quadro final para realizar a extensão.

​
Callback assíncrono

Como o tempo para o Luma gerar vídeos é relativamente longo, levando cerca de 1 a 2 minutos, se a API não responder por muito tempo, a solicitação HTTP permanecerá conectada, resultando em consumo adicional de recursos do sistema. Portanto, esta API também oferece suporte a callbacks assíncronos. O fluxo geral é: quando o cliente inicia uma solicitação, ele especifica adicionalmente um campo callback_url. Após o cliente iniciar uma solicitação de API, a API retornará imediatamente um resultado, contendo um campo task_id, que representa o ID da tarefa atual. Quando a tarefa for concluída, o resultado da geração de música será enviado em formato POST JSON para o callback_url especificado pelo cliente, incluindo também o campo task_id, para que o resultado da tarefa possa ser associado por meio do ID. A seguir, vamos entender como operar especificamente por meio de um exemplo. Primeiramente, o callback Webhook é um serviço que pode receber solicitações HTTP, e o desenvolvedor deve substituí-lo pela URL de um servidor HTTP criado por ele mesmo. Aqui, para facilitar a demonstração, usamos um site público de exemplo de Webhook https://webhook.site/. Ao abrir esse site, é possível obter uma URL de Webhook, conforme mostrado na imagem:

Copie esta URL para usá-la como Webhook; o exemplo aqui é https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13. Em seguida, podemos definir o campo callback_url como a URL de Webhook acima e, ao mesmo tempo, preencher o prompt, conforme mostrado na imagem:

Clique em executar e será possível observar que um resultado será obtido imediatamente, conforme abaixo:
Aguarde um momento, e poderemos observar o resultado da geração da música em https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13, conforme mostrado na imagem: O conteúdo é o seguinte:
É possível ver que há um campo task_id no resultado. Os outros campos são semelhantes aos descritos acima, e a associação da tarefa pode ser realizada por meio desse campo.