Перейти до основного вмісту

​
Вступ

Luma — це AI відеосервіс від Ace Data Cloud, Luma Dream Machine для генерації відео. Через уніфікований API Ace Data Cloud ви можете швидко інтегрувати Luma за допомогою Python для створення відео за текстом, відео за зображенням, продовження відео, контролю початкових і кінцевих кадрів, циклічного відео тощо.

​
Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Середовище Python 3.7 і вище
  • Встановлення бібліотеки requests: pip install requests

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

Основна кінцева точка для виклику Luma API: 
POST https://api.acedata.cloud/luma/videos
Повний приклад коду на Python: 
import requests

url = "https://api.acedata.cloud/luma/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "prompt": "Astronauts shuttle from space to volcano",
    "action": "generate",
    "enhancement": true
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

​
Обробка відповіді

Після успішного виклику API повертає дані у форматі JSON. Рекомендується перевіряти HTTP статус-код: 
if response.status_code == 200:
    result = response.json()
    print("Виклик успішний:", result)
else:
    print(f"Виклик не вдався, статус код: {response.status_code}")
    print(response.text)

​
Розширене використання

Для API, що підтримують асинхронні завдання, можна отримувати результати через callback URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Результати будуть надіслані на ваш сервер через callback URL

​
Обробка помилок

Поширені коди помилок:
Код стануОпис
401Помилка автентифікації, перевірте API Token
403Недостатньо коштів або відсутній доступ
429Перевищено ліміт частоти запитів
500Внутрішня помилка сервера

​
Інші кінцеві точки

Сервіс Luma також надає такі кінцеві точки:
  • POST https://api.acedata.cloud/luma/tasks

​
Наступні кроки