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

​
Вступ

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

​
Передумови

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

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

Основна кінцева точка для виклику OpenAI API: 
POST https://api.acedata.cloud/openai/chat/completions
У цьому прикладі використовується модель gpt-4o.
Доступні моделі: gpt-4o, gpt-4o-mini, o1, o3-mini. Повний приклад коду на Python: 
import requests

url = "https://api.acedata.cloud/openai/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "model": "gpt-4o",
    "messages": [
        {
            "role": "user",
            "content": "你好，请介绍一下你自己"
        }
    ],
    "max_tokens": 1024,
    "temperature": 0.7
}

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 підтримується потоковий вивід для отримання відповіді в реальному часі: 
import requests

data['stream'] = True
response = requests.post(url, headers=headers, json=data, stream=True)
for line in response.iter_lines():
    if line:
        print(line.decode())

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

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

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

Сервіс OpenAI також надає наступні кінцеві точки:
  • POST https://api.acedata.cloud/openai/embeddings
  • POST https://api.acedata.cloud/openai/images/generations
  • POST https://api.acedata.cloud/openai/responses

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