Luma відео генерації API інтеграція

З поширенням застосування ШІ, різноманітні програми на базі ШІ поступово стають звичними. ШІ все більше проникає в усі сфери життя людей. А галузі, пов’язані з ШІ, також стають дедалі різноманітнішими, починаючи з письма, медицини та освіти, і закінчуючи сьогоднішніми відео. Luma — це професійна платформа для генерації високоякісних відео, де користувачам потрібно лише завантажити матеріали, і на основі різних стилів та ефектів автоматично генеруються високоякісні відео. Цей генератор відео на базі ШІ розроблений командою з відомих технологічних компаній, мета якої — дозволити кожному легко створювати чудові відео без складних інструментів редагування. Однак Luma офіційно не надає API, AceDataCloud пропонує набір API для Luma, який імітує інтеграцію з офіційним Suno, що дозволяє швидко та зручно генерувати бажані відео.

Заявка та використання

Щоб використовувати Luma Videos Generation API, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, зберігайте його для подальшого використання.

Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на цю сторінку. Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо запитувати для кожної послуги. Перший запит надає безкоштовний ліміт, щоб ви могли безкоштовно спробувати; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.

📘 Повна документація: Luma Videos Generation API →

Основне використання

Щоб згенерувати відео, ви можете ввести будь-який текст, наприклад, якщо я хочу згенерувати відео про астронавтів, які переміщуються між космосом і вулканом, я можу ввести Astronauts shuttle from space to volcano, як показано на малюнку:

Згенерований код виглядає так:

Основні параметри запиту:

prompt: підказка для генерації відео.
aspect_ratio: співвідношення сторін відео, за замовчуванням 16:9.
end_image_url: необов’язковий, вказує на кінцевий кадр.
enhancement: необов’язковий, перемикач покращення чіткості.
loop: чи потрібно генерувати циклічне відео, за замовчуванням false.
timeout: необов’язковий, кількість секунд до тайм-ауту.
callback_url: адреса асинхронного зворотного виклику.
async: необов’язковий, якщо встановити true, інтерфейс відразу повертає task_id, не потрібно надавати callback_url, потім через відповідний інтерфейс запиту завдань можна опитувати для отримання результату.

Ви можете натиснути кнопку «Try», щоб безпосередньо протестувати API, почекайте 1-2 хвилини, результат буде таким:

{
  "success": true,
  "task_id": "e4018a99-1522-4f24-9330-62c2a9b50b59",
  "video_id": "155838f8-7f1e-44d8-b387-192f3b4b509d",
  "prompt": "Astronauts shuttle from space to volcano",
  "video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4",
  "video_height": 752,
  "video_width": 1360,
  "state": "completed",
  "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/e4018a99-1522-4f24-9330-62c2a9b50b59.jpg",
  "thumbnail_width": 1360,
  "thumbnail_height": 752
}

Ми можемо побачити, що в цей момент ми отримали цю інформацію про відео, включаючи ID відео, посилання на відео, обкладинку відео тощо. Опис полів:

success: чи була генерація успішною, якщо так, то true, інакше false
task_id: унікальний ID завдання на генерацію відео
video_id: унікальний ID відео, створеного в результаті завдання
prompt: ключові слова завдання на генерацію відео
video_url: посилання на результуюче відео
video_height: висота зображення обкладинки згенерованого відео
video_width: ширина зображення обкладинки згенерованого відео
state: статус завдання на генерацію відео, якщо завдання завершено, то completed.
thumbnail_url: посилання на зображення обкладинки згенерованого відео
thumbnail_width: ширина зображення обкладинки згенерованого відео
thumbnail_height: висота зображення обкладинки згенерованого відео

Налаштування генерації початкових та кінцевих кадрів

Якщо ви хочете згенерувати відео, використовуючи налаштовані початкові та кінцеві кадри, ви можете ввести посилання на зображення початкових та кінцевих кадрів: У цьому випадку поле start_image_url може приймати наступне зображення як початковий кадр відео:

Далі ми повинні налаштувати генерацію відео на основі початкового та кінцевого кадрів, ключових слів, і можемо вказати такі параметри:

action: дія завдання на генерацію відео, зазвичай це звичайна генерація generate та розширена генерація extend, за замовчуванням generate.
start_image_url: вказує на початковий кадр відео.
end_image_url: вказує на кінцевий кадр відео.
prompt: ключові слова для генерації відео.

Приклад заповнення виглядає так:

Після заповнення автоматично згенерувався код:

Відповідний код:

import requests

url = "https://api.acedata.cloud/luma/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "start_image_url": "https://cdn.acedata.cloud/r9vsv9.png",
    "action": "generate",
    "prompt": "Astronauts shuttle from space to volcano"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Отриманий результат виглядає так:

{
  "success": true,
  "task_id": "12a18694-fd4b-47e7-9c50-34f30862cff6",
  "video_id": "0105c090-03a5-425a-8026-523341cd575b",
  "prompt": "Astronauts shuttle from space to volcano",
  "video_url": "https://platform.cdn.acedata.cloud/luma/12a18694-fd4b-47e7-9c50-34f30862cff6.mp4",
  "video_height": 656,
  "video_width": 1552,
  "state": "completed",
  "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/12a18694-fd4b-47e7-9c50-34f30862cff6.jpg",
  "thumbnail_width": 1552,
  "thumbnail_height": 656
}

Остаточний результат подібний до попереднього, згенероване відео має початковий кадр, що містить передане зображення, звичайно, також можна передати посилання на зображення початкового та кінцевого кадрів для генерації відео, просто потрібно додати ще одне зображення для кінцевого кадру, інформація про яке виглядає так: Кінцевий кадр

Приклад заповнення виглядає так:

Остаточний результат:

{
  "success": true,
  "task_id": "d1cb723a-e554-4775-94a4-bb6ae8c7ea67",
  "video_id": "6bebd0d2-f793-472e-9326-38528a9273bb",
  "prompt": "Астронавти переміщуються з космосу до вулкана",
  "video_url": "https://platform.cdn.acedata.cloud/luma/d1cb723a-e554-4775-94a4-bb6ae8c7ea67.mp4",
  "video_height": 656,
  "video_width": 1552,
  "state": "completed",
  "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/d1cb723a-e554-4775-94a4-bb6ae8c7ea67.jpg",
  "thumbnail_width": 1552,
  "thumbnail_height": 656
}

Результат схожий на попередній, згенроване відео одночасно містить зображення першого та останнього кадрів, що завершило налаштування кастомних початкових та кінцевих кадрів для генерації відео.

Функція розширення відео

Якщо ви хочете продовжити генерацію згенерованого відео, ви можете встановити параметр action на extend і ввести ID або посилання на відео, ID відео та посилання на відео можна отримати відповідно до базового використання, як показано на малюнку нижче:

Тут можна побачити, що ID відео:

"video_id": "0105c090-03a5-425a-8026-523341cd575b",
"video_url": "https://platform.cdn.acedata.cloud/luma/12a18694-fd4b-47e7-9c50-34f30862cff6.mp4"

Зверніть увагу, що в цьому відео video_id та video_url є ID та посиланням на згенероване відео, якщо ви не знаєте, як згенерувати відео, ви можете звернутися до базового використання, щоб згенерувати відео.

Щоб продовжити генерацію відео, необхідно завантажити посилання на відео або ID відео, нижче показано, як використовувати ID відео для розширення, далі ми повинні заповнити ключові слова для кастомізації генерації відео, щоб вказати наступний вміст:

action: на цей раз дія розширення відео, тут має бути extend.
prompt: ключові слова, які потрібно розширити для відео.
video_url: посилання на відео, яке потрібно розширити.
video_id: унікальний ID відео, яке потрібно розширити.
end_image_url: посилання на зображення кінцевого кадру для розширення, необов’язковий параметр.

Приклад заповнення нижче:

Після заповнення автоматично згенерувався код нижче:

Відповідний код Python:

import requests

url = "https://api.acedata.cloud/luma/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "extend",
    "video_id": "0105c090-03a5-425a-8026-523341cd575b",
    "prompt": "Астронавти переміщуються з космосу до вулкана"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Натиснувши “Запустити”, можна побачити результат, як показано нижче:

{
  "success": true,
  "task_id": "c6e529d1-a06d-4c12-91b2-c855135131c3",
  "video_id": "36908c49-c2bb-4a11-bd5a-b8512b004818",
  "prompt": "Астронавти переміщуються з космосу до вулкана",
  "video_url": "https://platform.cdn.acedata.cloud/luma/c6e529d1-a06d-4c12-91b2-c855135131c3.mp4",
  "video_height": 656,
  "video_width": 1552,
  "state": "completed",
  "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/c6e529d1-a06d-4c12-91b2-c855135131c3.jpg",
  "thumbnail_width": 1552,
  "thumbnail_height": 656
}

Можна побачити, що це відео було розширено на основі відео, яке потрібно розширити, результат збігається з попереднім, що реалізує функцію продовження генерації пісні. Звичайно, ми також можемо вказати посилання на відео для розширення, заповнивши наступну інформацію:

Після запуску отримали наступний результат:

{
  "success": true,
  "task_id": "1dcb5902-a7be-4b77-ba5d-dd8ec82b26ca",
  "video_id": "f0187dc2-339f-4a08-a435-c3a3341f620a",
  "prompt": "Астронавти переміщуються з космосу до вулкана",
  "video_url": "https://platform.cdn.acedata.cloud/luma/1dcb5902-a7be-4b77-ba5d-dd8ec82b26ca.mp4",
  "video_height": 656,
  "video_width": 1552,
  "state": "completed",
  "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/1dcb5902-a7be-4b77-ba5d-dd8ec82b26ca.jpg",
  "thumbnail_width": 1552,
  "thumbnail_height": 656
}

З результату видно, що за допомогою посилання на відео також можна реалізувати функцію розширення відео. Нарешті, ми також можемо вказати зображення кінцевого кадру для розширення відео, нижче наведена інформація про зображення кінцевого кадру: Кінцевий кадр

Далі на основі вищеописаного додаємо інформацію про зображення кінцевого кадру, конкретно, як показано нижче:

Натиснувши “Запустити”, отримали наступну інформацію:

{
  "success": true,
  "task_id": "b816b2b4-c345-4673-9e19-83e91f91b643",
  "video_id": "c5400053-63e6-4206-8082-31cf9dd1e7ed",
  "prompt": "Астронавти переміщуються з космосу до вулкана",
  "video_url": "https://platform.cdn.acedata.cloud/luma/b816b2b4-c345-4673-9e19-83e91f91b643.mp4",
  "video_height": 656,
  "video_width": 1552,
  "state": "completed",
  "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/b816b2b4-c345-4673-9e19-83e91f91b643.jpg",
  "thumbnail_width": 1552,
  "thumbnail_height": 656
}

Можна побачити, що на основі розширеного відео вище, також можна вказати зображення кінцевого кадру для розширення.

Асинхронний зворотний виклик

Оскільки час генерації відео Luma відносно довгий, приблизно 1-2 хвилини, якщо API довго не відповідає, HTTP запит буде постійно підтримувати з’єднання, що призводить до додаткових витрат системних ресурсів, тому цей API також надає підтримку асинхронного зворотного виклику. Загальний процес такий: коли клієнт ініціює запит, він додатково вказує поле callback_url. Після того, як клієнт ініціює API запит, API негайно повертає результат, що містить інформацію про поле task_id, яке представляє поточний ID завдання. Коли завдання завершено, результат генерації музики буде надіслано на вказаний клієнтом callback_url у форматі POST JSON, де також буде включено поле task_id, таким чином результати завдання можна буде пов’язати за ID. Далі ми розглянемо приклад, щоб зрозуміти, як саме це працює. По-перше, Webhook зворотний виклик — це сервіс, який може приймати HTTP запити, розробники повинні замінити його на URL свого HTTP сервера. Для зручності демонстрації використовується публічний сайт з прикладом Webhook https://webhook.site/, відкривши цей сайт, ви отримаєте Webhook URL, як показано на малюнку:

Скопіюйте цей URL, і ви зможете використовувати його як Webhook, приклад тут — https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13. Далі ми можемо налаштувати поле callback_url на вказаний Webhook URL, одночасно заповнивши prompt, як показано на малюнку:

Натиснувши “Запустити”, ви відразу отримаєте результат, як показано нижче:

{
  "task_id": "732f8282-7cf8-401c-95f2-42c33aa079a6"
}

Почекавши деякий час, ми можемо спостерігати результати генерації пісні на https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13, як показано на малюнку:

Зміст такий:

{
    "success": true,
    "task_id": "732f8282-7cf8-401c-95f2-42c33aa079a6",
    "video_id": "4d8013c3-5de0-41aa-966e-0b1a51d1c633",
    "prompt": "Астронавти переносяться з космосу до вулкана",
    "video_url": "https://platform.cdn.acedata.cloud/luma/732f8282-7cf8-401c-95f2-42c33aa079a6.mp4",
    "video_height": 752,
    "video_width": 1360,
    "state": "completed",
    "thumbnail_url": "https://platform.cdn.acedata.cloud/luma/732f8282-7cf8-401c-95f2-42c33aa079a6.jpg",
    "thumbnail_width": 1360,
    "thumbnail_height": 752
}

Можна побачити, що в результаті є поле task_id, інші поля схожі на наведені вище, за допомогою цього поля можна реалізувати зв’язок завдань.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Проксі

Advanced

Coding

Luma відео генерації API інтеграція

Заявка та використання

Основне використання

Налаштування генерації початкових та кінцевих кадрів

Функція розширення відео

Асинхронний зворотний виклик

​Заявка та використання

​Основне використання

​Налаштування генерації початкових та кінцевих кадрів

​Функція розширення відео

​Асинхронний зворотний виклик

Заявка та використання

Основне використання

Налаштування генерації початкових та кінцевих кадрів

Функція розширення відео

Асинхронний зворотний виклик