Як інтегрувати Claude API у ваш застосунок

Щоб інтегрувати Claude API, створіть ключ API в Claude Console від Anthropic, збережіть його як серверний секрет (зазвичай ANTHROPIC_API_KEY) і викликайте Messages API з маршруту на вашому сервері, використовуючи один з офіційних SDK від Anthropic. Кожен запит називає модель, задає max_tokens (найдовшу відповідь, яку ви приймаєте) і передає розмову як messages, а ваші інструкції — в окремому system-промпті. Встановіть ліміт витрат, стрімте довгі відповіді та обробляйте помилки обмеження частоти (429) і перевантаження (529) повторними спробами.

Цей посібник охоплює налаштування, безпечний потік запитів, промпти для AI-білдера і помилки, до яких треба бути готовим. Дані про Anthropic взято з її документації станом на вересень 2026 року. Щоб загалом зрозуміти, як працюють токени і ціноутворення, дивіться як використовувати LLM API.

Що можна побудувати з його допомогою

• AI-асистенти в чаті та віджети допомоги (як створити застосунок-чатбот на AI)
• Резюме, переписування тексту та чернетки відповідей
• Витягування полів з документів, листів і форм
• Відповіді на запитання за вашим власним контентом
• Агенти, які викликають функції вашого застосунку через використання інструментів (tool use)

Більше ідей — у статті як додати AI-функції до застосунку.

Коротко про Messages API

Згідно з довідкою API від Anthropic, запит — це POST на https://api.anthropic.com/v1/messages з такими частинами:

API не зберігає стан: щоб продовжити розмову, надсилайте попередні репліки знову з кожним запитом. Тому довгі чати коштують дорожче за кожне повідомлення.

Anthropic публікує офіційні SDK для Python, TypeScript, C#, Go, Java, PHP і Ruby. Вони встановлюють заголовки, розбирають відповіді й підтримують стримінг. Використовуйте їх замість сирого HTTP, якщо немає причин цього не робити.

Вибір моделі

Anthropic пропонує кілька моделей Claude, які по-різному поєднують можливості, швидкість і ціну, і лінійка моделей змінюється. Беріть найменшу модель, яка добре виконує ваше завдання, перевіряйте її на реальних прикладах і зберігайте ідентифікатор моделі в конфігурації, щоб міняти його без змін у коді. Актуальні варіанти й тарифи дивіться на сторінках Anthropic про моделі та ціни.

Налаштування облікового запису

1. Увійдіть у Claude Console на platform.claude.com і додайте оплату.
2. Створіть ключ API. Тримайте окремий ключ для тестування і для продакшену, щоб відкликати один, не зламавши інший.
3. Встановіть ліміт витрат. На сторінці помилок Anthropic зазначено, що коли використання досягає встановленого вами ліміту витрат, API повертає помилку 400, тож ваш застосунок має показувати зрозуміле повідомлення в цьому випадку.
4. Перегляньте ліміти частоти запитів для вашого облікового запису в Console; вони вимірюються на рівні організації.

Потік запитів

1. Користувач діє у вашому застосунку: надсилає повідомлення, натискає «Підсумувати».
2. Браузер викликає ваш серверний маршрут, а не Anthropic напряму.
3. Ваш сервер перевіряє, що користувач увійшов і має право користуватися функцією, і застосовує обмеження на користувача.
4. Він формує запит: системний промпт з вашими правилами, введення користувача та дані з вашої бази, потрібні для завдання.
5. Він викликає Messages API з ключем зі змінних середовища і розумним значенням max_tokens.
6. Він стрімить відповідь у браузер і логує використання токенів з відповіді.

Варіанти і компроміси

Промпти для вашого AI-білдера

Перша функція:

Додай панель «Запитати про цей документ». Вона викликає серверний маршрут POST /api/ask, який перевіряє, що користувач увійшов і є власником документа, а потім викликає Claude Messages API через офіційний SDK Anthropic з секретом ANTHROPIC_API_KEY. Прочитай ідентифікатор моделі із секрету CLAUDE_MODEL. Системний промпт: «Відповідай лише на основі наданого документа. Якщо відповіді в ньому немає, так і скажи». Надішли текст документа і запитання, встанови max_tokens на 800, стрімте відповідь на сторінку і ніколи не відкривай ключ у браузері.

Обмеження і помилки:

Обмеж кожного користувача 20 запитаннями на годину, відстежуючи їх у базі даних. Логуй вхідні та вихідні токени з кожної відповіді разом з ID користувача і ID запиту. При помилках 429 або 529 повторюй запит з експоненційною затримкою до 3 разів, враховуючи заголовок retry-after, потім покажи «Асистент зараз зайнятий, спробуйте трохи пізніше». Якщо API повідомляє про помилку ліміту витрат, покажи «AI-функції призупинено» і сповісти адміністратора.

Помилки, до яких треба бути готовим

З документації Anthropic про помилки — ті, з якими ваш застосунок справді зіткнеться:

Згідно з документацією Anthropic, офіційні SDK автоматично повторюють тимчасові збої (помилки з'єднання, обмеження частоти та помилки 5xx) за замовчуванням двічі з експоненційною затримкою, і це можна налаштувати. Кожна відповідь містить заголовок request-id; логуйте його, щоб підтримка могла відстежити проблеми.

Типові помилки

• Виклик API з браузера. Ваш ключ стає публічним. Завжди працюйте через свій сервер. Див. як зберігати ключі API в безпеці.
• Забути, що max_tokens — це обмеження, а не ціль. Встановлюйте його відповідно до потреб функції: занадто мале значення обрізає відповіді, занадто велике тягне довгі й дорогі відповіді.
• Класти правила в повідомлення користувача. Сталі інструкції належать до промпту system, а права доступу — до вашого коду.
• Надсилати весь чат завжди. Скорочуйте або підсумовуйте старі репліки, коли розмова стає довгою.
• Немає ліміту витрат або обмеження на користувача.
• Жорстко прописаний ідентифікатор моделі. Моделі оновлюються і вилучаються.
• Ігнорувати причину зупинки. Якщо відповідь зупинилася через досягнення max_tokens, повідомте користувача або підвищте ліміт.

Чек-лист

• Ключ API створено в Claude Console і збережено як серверний секрет
• Окремі ключі для тестування та продакшену
• Встановлено ліміт витрат; зрозуміле повідомлення, коли його досягнуто
• Усі запити йдуть через ваш сервер з перевіркою прав
• Правила в системному промпті; ідентифікатор моделі налаштовується
• max_tokens задано для кожної функції; довгі відповіді стримляться
• Обмеження частоти на користувача в застосунку
• Помилки 429 і 529 оброблено з затримкою; ID запитів логуються
• Дружній стан помилки, який не ламає сторінку
• Протестовано з порожніми, дуже довгими та ворожими вхідними даними

Використання Claude API у Mythex

У застосунках, які ви будуєте на Mythex, функції Claude використовують ваш власний ключ Anthropic і оплачуються з вашого облікового запису Anthropic, а не з кредитів Mythex на створення. Це окремо від агента Mythex, який пише ваш код. Додайте ANTHROPIC_API_KEY як секрет проєкту через /secrets, налаштування проєкту або картку секретів у чаті, а потім опишіть функцію за допомогою промптів, схожих на наведені вище. Після зміни секретів для опублікованого застосунку опублікуйте його знову. Стартовий промпт дивіться в Додавання AI-функцій з вашими власними ключами API. Якщо ви обираєте між провайдерами, як інтегрувати OpenAI API розглядає те саме для OpenAI.

Запитання