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

​
Вступ

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

​
Попередні умови

  • Мати акаунт Ace Data Cloud та отримати API Token
  • Встановлене середовище терміналу з cURL

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

Головна кінцева точка виклику OpenAI API: 
POST https://api.acedata.cloud/openai/chat/completions
У цьому прикладі використовується модель gpt-4o.
Доступні моделі: gpt-4o, gpt-4o-mini, o1, o3-mini. Повний приклад команди cURL: 
curl -X POST https://api.acedata.cloud/openai/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}'
Будь ласка, замініть YOUR_API_TOKEN на реальний токен, отриманий на платформі Ace Data Cloud.

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

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

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

Рекомендується використовувати інструмент jq для форматування виводу: 
curl -s -X POST https://api.acedata.cloud/openai/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}], "max_tokens": 1024, "temperature": 0.7}' | jq .

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

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

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