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

​
Вступ

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

​
Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Встановлене середовище терміналу з cURL

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

Основна кінцева точка для виклику Sora API: 
POST https://api.acedata.cloud/sora/videos
У цьому прикладі використовується модель sora-2. Доступні моделі: sora-2, sora-2-pro. Повний приклад команди cURL: 
curl -X POST https://api.acedata.cloud/sora/videos \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cat running across a sunny meadow", "model": "sora-2", "duration": 10, "orientation": "landscape"}'
Замість YOUR_API_TOKEN вставте фактичний токен, отриманий на платформі Ace Data Cloud.

​
Приклад відповіді

Після успішного виклику повертається JSON-дані, наприклад: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Обробка відповіді за допомогою jq

Рекомендується використовувати інструмент jq для форматованого виводу: 
curl -s -X POST https://api.acedata.cloud/sora/videos \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cat running across a sunny meadow", "model": "sora-2", "duration": 10, "orientation": "landscape"}' | jq .

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

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

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