Ako integrovať Claude API do svojej appky

Ak chcete integrovať Claude API, vytvorte API kľúč v Claude Console od Anthropicu, uložte ho ako tajomstvo na strane servera (zvyčajne ANTHROPIC_API_KEY) a volajte Messages API z trasy na vlastnom serveri pomocou jedného z oficiálnych SDK od Anthropicu. Každá požiadavka uvádza model, nastavuje max_tokens (najdlhšiu odpoveď, ktorú prijmete) a posiela konverzáciu ako messages, pričom vaše pokyny sú v samostatnom system prompte. Nastavte limit výdavkov, dlhé odpovede streamujte a chyby limitov (429) a preťaženia (529) ošetrite opakovaním.

Tento návod pokrýva nastavenie, bezpečný tok požiadaviek, prompty pre AI tvorcu appiek a chyby, s ktorými treba počítať. Údaje od Anthropicu sú z jeho dokumentácie k septembru 2026. Ako fungujú tokeny a ceny vo všeobecnosti, nájdete v článku ako používať LLM API.

Čo sa s tým dá postaviť

• Chatovacie asistenty a pomocné okná (ako vytvoriť appku s AI chatbotom)
• Zhrnutia, prepisy a navrhnuté odpovede
• Extrakcia polí z dokumentov, e-mailov a formulárov
• Odpovede na otázky z vášho vlastného obsahu
• Agenti, ktorí volajú funkcie vašej appky cez tool use

Viac nápadov nájdete v článku ako pridať AI funkcie do appky.

Messages API v skratke

Podľa referencie API od Anthropicu je požiadavka POST na https://api.anthropic.com/v1/messages s týmito časťami:

API je bezstavové: aby ste pokračovali v konverzácii, posielajte predchádzajúce ťahy znova pri každej požiadavke. Preto je dlhý chat pri každej správe drahší.

Anthropic publikuje oficiálne SDK pre Python, TypeScript, C#, Go, Javu, PHP a Ruby. Nastavujú hlavičky, spracúvajú odpovede a podporujú streamovanie. Použite ich namiesto surového HTTP, pokiaľ nemáte dôvod inak.

Výber modelu

Anthropic ponúka viac modelov Claude, ktoré obchodujú schopnosti za rýchlosť a cenu, a ich ponuka sa mení. Vyberte najmenší model, ktorý úlohu zvládne dobre, otestujte ho na reálnych príkladoch a ID modelu držte v konfigurácii, aby ste ho mohli prepnúť bez zmeny kódu. Aktuálne možnosti a sadzby nájdete na stránkach Anthropicu s modelmi a cenami.

Nastavenie účtu

1. Prihláste sa do Claude Console na platform.claude.com a pridajte fakturáciu.
2. Vytvorte API kľúč. Mať jeden kľúč na prostredie (testovanie a produkcia) umožní zrušiť jeden bez porušenia druhého.
3. Nastavte limit výdavkov. Stránka chýb od Anthropicu uvádza, že keď využitie dosiahne limit výdavkov, ktorý ste nastavili, API vráti chybu 400, takže vaša appka má ukázať jasnú správu, keď sa to stane.
4. Skontrolujte limity požiadaviek pre svoj účet v Console; sú merané na organizáciu.

Tok požiadaviek

1. Používateľ koná vo vašej appke: pošle správu, klikne na „Zhrnúť“.
2. Prehliadač volá vašu trasu na serveri, nikdy priamo Anthropic.
3. Váš server skontroluje, či je používateľ prihlásený a smie túto funkciu použiť, a uplatní limit na používateľa.
4. Zostaví požiadavku: systémový prompt s vašimi pravidlami, vstup používateľa a všetky dáta z databázy, ktoré úloha potrebuje.
5. Zavolá Messages API s kľúčom z prostredia a rozumnou hodnotou max_tokens.
6. Odpoveď streamuje do prehliadača a zaznamenáva využitie tokenov z odpovede.

Možnosti a kompromisy

Prompty pre vášho AI tvorcu

Prvá funkcia:

Pridaj panel „Opýtať sa na tento dokument“. Volá serverovú trasu POST /api/ask, ktorá skontroluje, že je používateľ prihlásený a vlastní dokument, potom volá Claude Messages API cez oficiálne Anthropic SDK a tajomstvo ANTHROPIC_API_KEY. ID modelu čítaj z tajomstva CLAUDE_MODEL. Systémový prompt: „Odpovedaj len z poskytnutého dokumentu. Ak odpoveď v ňom nie je, povedz to.“ Pošli text dokumentu a otázku, nastav max_tokens na 800, streamuj odpoveď na stránku a kľúč nikdy nevystavuj v prehliadači.

Pravidlá a chyby:

Obmedz každého používateľa na 20 otázok za hodinu, sledované v databáze. Zaznamenávaj vstupné a výstupné tokeny z každej odpovede s ID používateľa a ID požiadavky. Pri chybách 429 alebo 529 opakuj s exponenciálnym odstupom až 3-krát, rešpektuj hlavičku retry-after a potom zobraz „Asistent je zaneprázdnený, skús to čoskoro znova.“ Ak API nahlási chybu limitu výdavkov, zobraz „Funkcie AI sú pozastavené“ a upozorni administrátora.

Chyby, s ktorými treba počítať

Z dokumentácie Anthropicu k chybám tie, s ktorými sa vaša appka skutočne stretne:

Dokumentácia Anthropicu uvádza, že oficiálne SDK automaticky opakujú dočasné zlyhania (chyby spojenia, limity požiadaviek a chyby 5xx) predvolene dvakrát s exponenciálnym odstupom, a dá sa to nastaviť. Každá odpoveď nesie hlavičku request-id; zaznamenávajte ju, aby podpora mohla problémy vystopovať.

Časté chyby

• Volanie API z prehliadača. Váš kľúč bude verejný. Vždy choďte cez svoj server. Pozrite ako chrániť API kľúče.
• Zabudnutie, že max_tokens je strop, nie cieľ. Nastavte ho na to, čo funkcia potrebuje; príliš nízka hodnota odpoveď skráti, príliš vysoká riskuje dlhé a drahé odpovede.
• Pravidlá v používateľskej správe. Stále pokyny patria do system promptu; oprávnenia patria do vášho kódu.
• Posielanie celého chatu navždy. Skracujte alebo sumarizujte staršie ťahy, keď konverzácie rastú.
• Žiadny limit výdavkov ani limit na používateľa.
• Napevno zapísané ID modelu. Modely sa aktualizujú a vyraďujú.
• Ignorovanie stop reason. Ak odpoveď skončila, lebo dosiahla max_tokens, povedzte to používateľovi alebo zvýšte strop.

Kontrolný zoznam

• API kľúč vytvorený v Claude Console a uložený ako tajomstvo na strane servera
• Oddelené kľúče pre testovanie a produkciu
• Nastavený limit výdavkov; jasná správa, keď sa dosiahne
• Všetky požiadavky idú cez váš server s kontrolou oprávnení
• Systémový prompt obsahuje pravidlá; ID modelu je nastaviteľné
• max_tokens nastavené pre každú funkciu; dlhé odpovede streamované
• Limit požiadaviek na používateľa vo vašej appke
• Chyby 429 a 529 ošetrené s odstupom; ID požiadaviek zaznamenané
• Priateľský stav chyby, ktorý nerozbije stránku
• Otestované s prázdnymi, veľmi dlhými a nepriateľskými vstupmi

Použitie Claude API v Mythexe

V appkách, ktoré stavate na Mythexe, funkcie Claude používajú váš vlastný kľúč Anthropic a fakturujú sa na váš účet Anthropic, nie na kredity Mythexu na budovanie. To je oddelené od agenta Mythexu, ktorý píše váš kód. Pridajte ANTHROPIC_API_KEY ako tajomstvo projektu cez /secrets, nastavenia projektu alebo kartu tajomstiev v chate a potom opíšte funkciu pomocou promptov podobných tým vyššie. Po zmene tajomstiev na živej appke ju znova publikujte. Počiatočný prompt nájdete v návode Pridanie AI funkcií s vlastnými API kľúčmi. Ak vyberáte medzi poskytovateľmi, článok ako integrovať OpenAI API pokrýva to isté pre OpenAI.

Otázky