Как да интегрирате 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 чатбот)
• Резюмета, пренаписвания и чернови на отговори
• Извличане на полета от документи, имейли и формуляри
• Отговори на въпроси от собственото ви съдържание
• Агенти, които извикват функциите на приложението ви чрез tool use

За още идеи вижте как да добавите AI функции в приложението си.

Messages 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 с официалния Anthropic SDK и тайната 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.

Въпроси