Швидкий старт Sora JavaScript

Вступ

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

Передумови

Наявність облікового запису Ace Data Cloud та отримання API Token
Node.js 18+ або сучасне браузерне середовище

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

Основна кінцева точка виклику API Sora:

POST https://api.acedata.cloud/sora/videos

У цьому прикладі використовується модель sora-2. Доступні моделі: sora-2, sora-2-pro. Повний приклад коду на JavaScript:

const response = await fetch("https://api.acedata.cloud/sora/videos", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "prompt": "A cat running across a sunny meadow",
  "model": "sora-2",
  "duration": 10,
  "orientation": "landscape"
}),
});

const result = await response.json();
console.log(result);

Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

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

Рекомендується перевіряти код стану відповіді та обробляти помилки:

if (response.ok) {
  const result = await response.json();
  console.log("Виклик успішний:", result);
} else {
  console.error(`Виклик не вдався, код стану: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Обгортка для Node.js

Рекомендується створити багаторазову функцію:

async function callSora(data) {
  const response = await fetch("https://api.acedata.cloud/sora/videos", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

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

Поширені коди помилок:

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

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

Перейдіть до консолі Ace Data Cloud для отримання API Token
Ознайомтеся з документацією API для повного опису параметрів
Перегляньте плани тарифікації для ознайомлення з вартістю

Tutorials

​Вступ

​Передумови

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

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

​Обгортка для Node.js

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

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