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

​
Вступ

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

​
Передумови

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

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

Основна кінцева точка для виклику Claude API: 
POST https://api.acedata.cloud/v1/chat/completions
У цьому прикладі використовується модель claude-sonnet-4-6. Доступні моделі: claude-sonnet-4-6, claude-opus-4-5-20251101, claude-3-5-sonnet. Повний приклад коду Python: 
import requests

url = "https://api.acedata.cloud/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "model": "claude-sonnet-4-6",
    "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Внутрішня помилка сервера

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

Сервіс Claude також надає такі кінцеві точки:
  • POST https://api.acedata.cloud/v1/messages
  • POST https://api.acedata.cloud/v1/messages/count_tokens

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