Како да го интегрирате Claude API во вашата апликација

За да го интегрирате Claude API, креирајте API клуч во Claude Console на Anthropic, чувајте го како тајна на серверска страна (обично ANTHROPIC_API_KEY) и повикајте го Messages API од рута на вашиот сопствен сервер, користејќи еден од официјалните SDK-а на Anthropic. Секое барање именува model, поставува max_tokens (најдолгиот одговор што го прифаќате) и го испраќа разговорот како messages, а вашите инструкции во посебно system упатство. Поставете лимит на трошење, стримајте долги одговори и справувајте се со грешките за ограничување на брзината (429) и преоптоварување (529) со повторни обиди.

Овој водич ги опфаќа поставувањето, безбеден тек на барањата, упатствата за AI градител и грешките на кои треба да се подготвите. Деталите за Anthropic се од нивната документација од септември 2026. За тоа како функционираат токените и цените општо, видете како да ги користите LLM API-ја.

Што можете да изградите со него

• Чет-асистенти и widget-и за помош (како да изградите апликација со 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 модели што ја разменуваат способноста наспроти брзината и цената, а понудата се менува. Изберете го најмалиот модел што добро ја врши вашата задача, тестирајте го на вистински примери и чувајте го ID-то на моделот во конфигурацијата за да може да се пренесете без промена на кодот. Проверете ги страниците за модели и цени на 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. Прочитај го ID-то на моделот од тајната 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 упатството; дозволите припаѓаат во вашиот код.
• Испраќање на целиот чет засекогаш. Скратете или сумирајте стари реплики како разговорите растат.
• Нема лимит на трошење или лимит по корисник.
• Фиксирање на ID на моделот во кодот. Моделите се ажурираат и се повлекуваат.
• Игнорирање на причината за застанување. Ако одговорот застанал затоа што ја достигнал границата max_tokens, кажете му на корисникот или подигнете ја границата.

Листа за проверка

• API клучот е креиран во Claude Console и чуван како тајна на серверска страна
• Посебни клучеви за тестирање и производство
• Поставен лимит на трошење; јасна порака кога ќе се достигне
• Сите барања минуваат преку вашиот сервер со проверки на дозволи
• Системското упатство ги содржи правилата; ID-то на моделот е конфигурабилно
• max_tokens поставен по функција; долгите одговори се стримаат
• Лимит на брзина по корисник во вашата апликација
• 429 и 529 се справени со доцнење; ID-та на барањата се бележат
• Пријателска состојба на грешка што не ја расипува страницата
• Тестирано со празни, многу долги и непријателски влезови

Користење на Claude API во Mythex

Во апликациите што ги градите на Mythex, Claude функциите користат ваш сопствен клуч од Anthropic и се наплаќаат на вашата сметка кај Anthropic, а не од кредитите за градење на Mythex. Тоа е одделно од агентот на Mythex што го пишува вашиот код. Додајте ANTHROPIC_API_KEY како тајна на проектот преку /secrets, поставките на проектот или картичката за тајни во чет, па опишете ја функцијата со упатства слични на горните. Објавете повторно откако ќе промените тајни на жива апликација. Видете Додајте AI функции со ваши сопствени API клучеви за стартувачко упатство. Ако избирате меѓу провајдери, како да го интегрирате OpenAI API ги опфаќа истите работи за OpenAI.

Прашања