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

​
Вступ

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

​
Передумови

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

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

Головна кінцева точка виклику OpenAI API: 
POST https://api.acedata.cloud/openai/chat/completions
У цьому прикладі використовується модель gpt-4o. Доступні моделі: gpt-4o, gpt-4o-mini, o1, o3-mini. Повний приклад коду на JavaScript: 
const response = await fetch("https://api.acedata.cloud/openai/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下你自己"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}),
});

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 callOpenAI(data) {
  const response = await fetch("https://api.acedata.cloud/openai/chat/completions", {
    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Внутрішня помилка сервера

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