Jak integrovat Claude API do své aplikace

Pro integraci Claude API vytvořte API klíč v Claude Console od Anthropicu, uložte ho jako tajný údaj na serveru (obvykle ANTHROPIC_API_KEY) a volejte Messages API z trasy na vašem vlastním serveru pomocí některého z oficiálních SDK od Anthropicu. Každý požadavek určuje model, nastavuje max_tokens (nejdelší odpověď, kterou přijmete) a posílá konverzaci jako messages, zatímco vaše instrukce jdou do odděleného system promptu. Nastavte limit výdajů, dlouhé odpovědi streamujte a chyby limitu požadavků (429) a přetížení (529) řešte opakováním.

Tento návod pokrývá nastavení, bezpečný postup požadavku, prompty pro AI builder a chyby, na které se připravit. Údaje o Anthropicu jsou z jeho dokumentace ke dni září 2026. Obecné principy tokenů a cen najdete v článku jak používat LLM API.

Co s ním můžete postavit

• Chatovací asistenty a nápovědné widgety (jak vytvořit aplikaci s AI chatbotem)
• Shrnutí, přepisy a navržené odpovědi na e-maily
• Vytahování polí z dokumentů, e-mailů a formulářů
• Odpovídání na otázky z vašeho vlastního obsahu
• Agenty, které volají funkce vaší aplikace přes použití nástrojů (tool use)

Další nápady najdete v článku jak přidat funkce AI do aplikace.

Messages API stručně

Podle referenční dokumentace API od Anthropicu je požadavek POST na https://api.anthropic.com/v1/messages s těmito částmi:

API nemá paměť: pokud chcete pokračovat v konverzaci, pošlete předchozí tahy znovu s každým požadavkem. Proto dlouhé chaty stojí víc za každou zprávu.

Anthropic publikuje oficiální SDK pro Python, TypeScript, C#, Go, Javu, PHP a Ruby. Nastavují hlavičky, zpracovávají odpovědi a podporují streamování. Použijte je místo surového HTTP, pokud nemáte důvod to nedělat.

Výběr modelu

Anthropic nabízí několik modelů Claude, které mění schopnosti za rychlost a cenu, a nabídka se mění. Vyberte nejmenší model, který váš úkol zvládne dobře, otestujte ho na reálných příkladech a ID modelu držte v konfiguraci, abyste ho mohli přepnout bez změny kódu. Aktuální možnosti a sazby najdete na stránkách Anthropicu s modely a cenami.

Nastavení účtu

1. Přihlaste se do Claude Console na platform.claude.com a přidejte fakturaci.
2. Vytvořte API klíč. Mějte jeden klíč pro každé prostředí (testování a produkce), abyste mohli jeden zrušit, aniž by se rozbil druhý.
3. Nastavte limit výdajů. Stránka chyb od Anthropicu uvádí, že když usage dosáhne limitu, který jste nastavili, API vrátí chybu 400, takže vaše aplikace by měla zobrazit jasnou zprávu.
4. Zkontrolujte limity požadavků pro svůj účet v Console; jsou měřeny na úrovni organizace.

Postup požadavku

1. Uživatel v aplikaci něco udělá: odešle zprávu, klikne na „Shrnout“.
2. Prohlížeč volá vaši trasu na serveru, nikdy přímo Anthropic.
3. Váš server ověří, že je uživatel přihlášen a smí funkci použít, a uplatní limit na uživatele.
4. Sestaví požadavek: systémový prompt s vašimi pravidly, vstup uživatele a případná data z databáze, která úkol potřebuje.
5. Zavolá Messages API s klíčem z prostředí a rozumným max_tokens.
6. Odpověď streamuje do prohlížeče a zaznamenává využití tokenů z odpovědi.

Možnosti a kompromisy

Prompty pro váš AI builder

První funkce:

Přidej panel „Zeptej se na tento dokument“. Volá serverovou trasu POST /api/ask, která ověří, že je uživatel přihlášen a dokument mu patří, pak zavolá Claude Messages API přes oficiální Anthropic SDK a tajný údaj ANTHROPIC_API_KEY. Název modelu načti z tajného údaje CLAUDE_MODEL. Systémový prompt: „Odpovídej pouze podle poskytnutého dokumentu. Pokud odpověď v něm není, řekni to.“ Pošli text dokumentu a otázku, nastav max_tokens na 800, odpověď streamuj na stránku a klíč nikdy neposílej do prohlížeče.

Pravidla a chyby:

Omez každého uživatele na 20 otázek za hodinu, sledovaných v databázi. U každé odpovědi zapisuj vstupní a výstupní tokeny s ID uživatele a ID požadavku. U chyb 429 nebo 529 opakuj požadavek s exponenciálním čekáním až třikrát a respektuj hlavičku retry-after. Pak zobraz „Asistent je zaneprázdněn, zkus to znovu za chvíli.“ Pokud API ohlásí chybu limitu výdajů, zobraz „Funkce AI jsou pozastaveny“ a upozorni administrátora.

Chyby, na které se připravit

Podle dokumentace Anthropicu k chybám ty, se kterými se vaše aplikace opravdu setká:

Anthropic uvádí, že oficiální SDK automaticky opakují přechodná selhání (chyby spojení, limity požadavků a chyby 5xx) dvakrát ve výchozím nastavení s exponenciálním čekáním, a dá se to nastavit. Každá odpověď nese hlavičku request-id; zapisujte ji, aby podpora mohla problémy dohledat.

Časté chyby

• Volání API z prohlížeče. Váš klíč se stane veřejným. Vždy jděte přes svůj server. Viz jak chránit API klíče.
• Zapomenutí, že max_tokens je strop, ne cíl. Nastavte ho podle toho, co funkce potřebuje; příliš nízké hodnoty odpovědi useknou, příliš vysoké riskují dlouhé a drahé odpovědi.
• Pravidla v uživatelské zprávě. Stálé instrukce patří do promptu system; oprávnění patří do vašeho kódu.
• Posílání celého chatu donekonečna. Staré tahy zkracujte nebo shrňujte, jak konverzace roste.
• Chybějící limit výdajů nebo limit na uživatele.
• Napevno zapsané ID modelu. Modely se aktualizují a vyřazují.
• Ignorování důvodu ukončení. Pokud odpověď skončila na max_tokens, řekněte to uživateli nebo zvyšte strop.

Kontrolní seznam

• API klíč vytvořen v Claude Console a uložen jako tajný údaj na serveru
• Oddělené klíče pro testování a produkci
• Nastaven limit výdajů; jasná zpráva, když je dosažen
• Všechny požadavky jdou přes váš server s kontrolou oprávnění
• Systémový prompt drží pravidla; ID modelu je nastavitelné
• max_tokens nastaveno pro každou funkci; dlouhé odpovědi se streamují
• Limit požadavků na uživatele ve vaší aplikaci
• Chyby 429 a 529 řešeny s čekáním; ID požadavků zapisována
• Přátelský stav chyby, který nerozbije stránku
• Otestováno s prázdnými, velmi dlouhými a nepřátelskými vstupy

Použití Claude API v Mythexu

V aplikacích, které stavíte v Mythexu, používají funkce Claude váš vlastní klíč Anthropic a účtují se na váš účet u Anthropicu, ne z kreditů na stavbu v Mythexu. To je odděleno od agenta Mythexu, který píše váš kód. Přidejte ANTHROPIC_API_KEY jako tajný údaj projektu přes /secrets, nastavení projektu nebo kartu s tajnými údaji v chatu, a pak funkci popište pomocí promptů podobných těm výše. Po změně tajných údajů u živé aplikace ji znovu publikujte. Startovací prompt najdete v návodu Přidání AI funkcí s vlastními API klíči. Pokud vybíráte mezi poskytovateli, jak integrovat OpenAI API popisuje totéž pro OpenAI.

Otázky