Skip to main content
Con la expansión de la aplicación de la IA, varios programas de IA se han vuelto gradualmente comunes. La IA ha penetrado en todos los aspectos de la vida laboral y cotidiana de las personas. Además, los sectores involucrados en la IA son cada vez más diversos, desde la escritura inicial, hasta la educación médica, y ahora, hasta los videos. Luma es una plataforma profesional de generación de videos de alta calidad, donde los usuarios solo necesitan subir material para generar automáticamente videos de alta calidad según diferentes estilos y efectos. Este generador de videos de IA ha sido desarrollado por miembros de un equipo de una conocida empresa tecnológica, con el objetivo de permitir que todos puedan crear videos excepcionales sin herramientas de edición complejas. Sin embargo, Luma no proporciona oficialmente una API, AceDataCloud ofrece un conjunto de API de Luma, simulando la integración con la oficial de Suno, lo que permite generar videos deseados de manera rápida y conveniente.

​
Solicitud y uso

Para utilizar la API de generación de videos de Luma, primero dirígete a Ace Data Cloud Console para obtener tu token de API, que debes guardar para uso futuro. Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión, y después volverás automáticamente a la página actual. Un token de API es suficiente para acceder a todos los servicios de la plataforma, sin necesidad de solicitar uno por cada servicio. La primera solicitud te otorgará un crédito gratuito para que puedas experimentar sin costo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de generación de videos de Luma →

​
Uso básico

Para generar un video, puedes ingresar cualquier texto, por ejemplo, si quiero generar un video sobre astronautas viajando entre el espacio y un volcán, puedo ingresar Astronauts shuttle from space to volcano, como se muestra en la imagen:

El código generado es el siguiente:

Parámetros de solicitud principales:
  • prompt: la palabra clave para generar el video.
  • aspect_ratio: la relación de aspecto del video, por defecto 16:9.
  • end_image_url: opcional, especifica el fotograma final.
  • enhancement: opcional, interruptor de mejora de claridad.
  • loop: si se debe generar un video en bucle, por defecto false.
  • timeout: opcional, número de segundos de tiempo de espera.
  • callback_url: dirección de callback asíncrona.
  • async: opcional, si se establece en true, la interfaz devuelve inmediatamente task_id, sin necesidad de proporcionar callback_url, y luego se puede consultar el resultado a través de la interfaz de consulta de tareas correspondiente.
Puedes hacer clic en el botón “Try” para probar la API directamente, espera 1-2 minutos, y el resultado es el siguiente:
Como se puede ver, en este momento hemos obtenido la información relacionada con este video, incluyendo el ID del video, el enlace del video, la miniatura del video, etc. La descripción de los campos es la siguiente:
  • success: indica si la generación fue exitosa, si es así, es true, de lo contrario, es false.
  • task_id: ID único de la tarea de generación de este video.
  • video_id: ID único del video generado por esta tarea.
  • prompt: palabra clave de la tarea de generación de este video.
  • video_url: enlace al video resultante de esta tarea de generación.
  • video_height: altura de la imagen de la miniatura del video generado.
  • video_width: ancho de la imagen de la miniatura del video generado.
  • state: estado de la tarea de generación de este video, si la tarea está completada, será completed.
  • thumbnail_url: enlace a la imagen de la miniatura generada.
  • thumbnail_width: ancho de la imagen de la miniatura generada.
  • thumbnail_height: altura de la imagen de la miniatura generada.

​
Generación de fotogramas iniciales y finales personalizados

Si deseas generar un video a través de fotogramas iniciales y finales personalizados, puedes ingresar los enlaces de las imágenes de los fotogramas: En este momento, el campo start_image_url puede recibir la siguiente imagen como el fotograma inicial del video: Fotograma inicial A continuación, debemos personalizar la generación del video según los fotogramas iniciales y finales, así que podemos especificar el siguiente contenido:
  • action: la acción de la tarea de generación de video, generalmente es generación normal generate y generación extendida extend, por defecto es generate.
  • start_image_url: especifica el fotograma inicial del video generado.
  • end_image_url: especifica el fotograma final del video generado.
  • prompt: contenido de la palabra clave para generar el video.
Un ejemplo de llenado es el siguiente:

Una vez completado, se generó automáticamente el siguiente código:

El código correspondiente es:
El resultado obtenido es el siguiente:
El resultado final es similar al anterior, el fotograma inicial del video generado incluye la imagen que proporcionamos, y también se pueden proporcionar enlaces de imágenes para los fotogramas inicial y final para generar el video, solo necesitas agregar un enlace de imagen para el fotograma final en la base anterior, la información de la imagen del fotograma final es la siguiente: Fotograma final Un ejemplo de llenado es el siguiente:

最后得出如下结果：
El resultado es similar al anterior, el video generado también contiene imágenes del primer y último fotograma, completando así la personalización de los fotogramas inicial y final para generar el video.

​
Función de extensión de video

Si desea continuar generando el video creado, puede establecer el parámetro action en extend, e ingresar el ID del video o el enlace del video que necesita continuar generando. El ID del video y el enlace del video se obtienen según el uso básico, como se muestra en la imagen a continuación:

En este momento, se puede ver que el ID del video es:
Nota: aquí el video_id y video_url del video son el ID y el enlace del video generado. Si no sabe cómo generar un video, puede consultar el uso básico mencionado anteriormente para generar un video.
Para continuar generando el video, debe cargar el enlace del video o el ID del video. A continuación, se muestra cómo usar el ID del video para realizar la extensión. Luego, debemos completar las palabras clave para personalizar la generación del video, especificando el siguiente contenido:
  • action: en este caso, la acción de extensión del video, que debe ser extend.
  • prompt: las palabras clave para extender el video.
  • video_url: el enlace del video que necesita ser extendido.
  • video_id: el ID único del video que necesita ser extendido.
  • end_image_url: el enlace de la imagen del fotograma final que se puede especificar para la extensión, es un parámetro opcional.
El ejemplo de llenado es el siguiente:

Una vez completado, se generó automáticamente el siguiente código:

El código correspondiente en Python:
Al hacer clic en ejecutar, se puede observar que se obtiene un resultado como el siguiente:
Se puede ver que este video se ha extendido sobre la base del video que necesita ser extendido, el contenido del resultado es consistente con el anterior, lo que también realiza la función de continuación de la generación de la canción. Por supuesto, también podemos especificar el enlace del video para realizar la extensión, completando la siguiente información:

Después de ejecutar, se obtuvo el siguiente resultado:
Según el resultado, se puede ver que también se puede realizar la función de extensión del video según el enlace del video. Finalmente, también podemos especificar una imagen de fotograma final en el video extendido para realizar la extensión. A continuación se muestra la información de la imagen del fotograma final: Fotograma final A continuación, se agrega la información de la imagen del fotograma final sobre la base anterior, como se muestra a continuación:

Al hacer clic en ejecutar, se obtiene la siguiente información:
Se puede ver que, sobre la base del video extendido anterior, también se puede especificar una imagen de fotograma final para realizar la extensión.

​
Callback asíncrono

Debido a que el tiempo de generación de videos de Luma es relativamente largo, aproximadamente de 1 a 2 minutos, si la API no responde durante mucho tiempo, la solicitud HTTP mantendrá la conexión, lo que provocará un consumo adicional de recursos del sistema. Por lo tanto, esta API también ofrece soporte para callbacks asíncronos. 整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成音乐的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。 下面我们通过示例来了解下具体怎样操作。 首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13。 接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：

点击运行，可以发现会立即得到一个结果，如下：
稍等片刻，我们可以在 https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13 上观察到生成歌曲的结果，如图所示： 内容如下：
可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。