Paano I-integrate ang Claude API sa Iyong App

Para i-integrate ang Claude API, gumawa ng API key sa Claude Console ng Anthropic, itago ito bilang server-side secret (kadalasang ANTHROPIC_API_KEY), at tawagin ang Messages API mula sa route sa sarili mong server gamit ang isa sa mga opisyal na SDK ng Anthropic. Ang bawat request ay nagbabanggit ng model, nagtatakda ng max_tokens (ang pinakamahabang sagot na tatanggapin mo), at ipinapadala ang usapan bilang messages, habang nasa hiwalay na system prompt ang mga tagubilin mo. Maglagay ng spend limit, mag-stream ng mahahabang sagot, at hawakan ang rate-limit (429) at overload (529) na error gamit ang retry.

Sakop ng gabay na ito ang setup, ligtas na daloy ng request, mga prompt para sa AI builder, at mga error na dapat paghandaan. Ang mga detalye ng Anthropic ay mula sa kanilang dokumentasyon noong Setyembre 2026. Para sa pangkalahatang paliwanag kung paano gumagana ang token at presyo, tingnan ang paano gumamit ng LLM API.

Ano ang puwede mong buuin dito

• Mga chat assistant at help widget (paano gumawa ng AI chatbot app)
• Mga buod, rewrite, at draft ng sagot
• Pagkuha ng mga field mula sa dokumento, email, at form
• Pagsagot ng mga tanong mula sa sarili mong content
• Mga agent na tumatawag sa mga function ng iyong app sa pamamagitan ng tool use

Para sa higit pang ideya, tingnan ang paano magdagdag ng AI features sa app mo.

Ang Messages API sa maikling salita

Ayon sa API reference ng Anthropic, ang request ay isang POST sa https://api.anthropic.com/v1/messages na may:

Stateless ang API: para ituloy ang usapan, ipadala ulit ang mga naunang turn sa bawat request. Kaya mas mahal kada mensahe ang mahahabang chat.

Naglalabas ang Anthropic ng mga opisyal na SDK para sa Python, TypeScript, C#, Go, Java, PHP, at Ruby. Sila na ang nagtatakda ng mga header, nagbabasa ng response, at sumusuporta sa streaming. Gamitin ang isa sa mga ito sa halip na raw HTTP, maliban kung may partikular kang dahilan.

Pagpili ng model

Nag-aalok ang Anthropic ng ilang Claude model na nagpapalitan ng kakayahan, bilis, at presyo, at nagbabago ang listahang ito. Piliin ang pinakamaliit na model na mahusay sa gawain mo, subukan ito sa totoong halimbawa, at panatilihin ang model ID sa configuration para makapagpalit nang hindi ginagalaw ang code. Tingnan ang models at pricing page ng Anthropic para sa kasalukuyang opsyon at rate.

Pag-set up ng account

1. Mag-sign in sa Claude Console sa platform.claude.com at mag-dagdag ng billing.
2. Gumawa ng API key. Magtabi ng isang key kada environment (testing at production) para mabawi mo ang isa nang hindi nasisira ang isa pa.
3. Mag-set ng spend limit. Nakasaad sa errors page ng Anthropic na kapag naabot ang spend limit na itinakda mo, nagbabalik ang API ng 400 error, kaya dapat magpakita ang app mo ng malinaw na mensahe kapag nangyari ito.
4. Suriin ang rate limit ng account mo sa Console; sinusukat ang mga ito kada organisasyon.

Daloy ng request

1. Kikilos ang user sa app mo: magpapadala ng mensahe, mag-click ng "Summarise".
2. Tatawag ang browser sa sarili mong server route, hindi direkta sa Anthropic.
3. Titingnan ng server mo kung naka-log in ang user at pinapayagang gamitin ang feature, at maglalagay ng limit kada user.
4. Bubuuin nito ang request: system prompt na may sarili mong patakaran, ang input ng user, at anumang datos mula sa database na kailangan ng gawain.
5. Tatawag ito sa Messages API gamit ang key mula sa environment at makatwirang max_tokens.
6. Ipo-stream nito ang sagot sa browser at itatala ang paggamit ng token mula sa response.

Mga opsyon at trade-off

Mga prompt para sa AI builder mo

Unang feature:

Magdagdag ng panel na "Magtanong tungkol sa dokumentong ito". Tatawag ito sa server route na POST /api/ask na titingin kung naka-log in ang user at siya ang may-ari ng dokumento, pagkatapos ay tatawag sa Claude Messages API gamit ang opisyal na Anthropic SDK at ang secret na ANTHROPIC_API_KEY. Basahin ang model ID mula sa secret na CLAUDE_MODEL. System prompt: "Sumagot lamang mula sa ibinigay na dokumento. Kung wala sa dokumento ang sagot, sabihin ito." Ipadala ang teksto ng dokumento at ang tanong, itakda ang max_tokens sa 800, i-stream ang sagot sa pahina, at huwag kailanman ipakita ang key sa browser.

Mga guardrail at error:

Limitahan ang bawat user sa 20 tanong bawat oras, itinatala sa database. I-log ang input at output token mula sa bawat response kasama ang user ID at request ID. Kapag may 429 o 529 na error, mag-retry gamit ang exponential backoff nang hanggang 3 beses, sinusunod ang anumang retry-after header, saka ipakita ang "Abala ang assistant, subukan ulit maya-maya." Kung sinabi ng API na naabot ang spend limit, ipakita ang "Naka-pause ang mga AI feature" at bigyan ng alerto ang admin.

Mga error na dapat paghandaan

Mula sa dokumentasyon ng errors ng Anthropic, ang mga error na talagang makakaharap ng app mo:

Sabi ng docs ng Anthropic na awtomatikong nire-retry ng mga opisyal na SDK ang mga pansamantalang pagkabigo (connection error, rate limit, at 5xx error) nang dalawang beses bilang default, gamit ang exponential backoff, at puwede itong i-configure. Bawat response ay may request-id header; itala ito para masubaybayan ng support ang mga problema.

Mga karaniwang pagkakamali

• Pagtawag sa API mula sa browser. Mapupunta sa publiko ang key mo. Laging dumaan sa server mo. Tingnan ang paano panatilihing ligtas ang API key.
• Pagkalimot na ang max_tokens ay limitasyon, hindi target. Itakda ito ayon sa kailangan ng feature; ang sobrang mababa ay pumuputol ng sagot, ang sobrang mataas ay nagdudulot ng mahaba at magastos na sagot.
• Paglalagay ng mga patakaran sa mensahe ng user. Ang matatatag na tagubilin ay dapat nasa system prompt; ang mga pahintulot ay dapat nasa code mo.
• Pagpapadala ng buong chat nang walang katapusan. Paikliin o i-buod ang mga lumang turn habang lumalaki ang usapan.
• Walang spend limit o limitasyon kada user.
• Hard-coded na model ID. Nagbabago at nare-retire ang mga model.
• Hindi pinapansin ang stop reason. Kung huminto ang sagot dahil naabot nito ang max_tokens, sabihin sa user o itaas ang limitasyon.

Checklist

• Nagawa ang API key sa Claude Console at naitago bilang server-side secret
• Magkahiwalay na key para sa testing at production
• Naitakda ang spend limit; malinaw na mensahe kapag naabot na
• Lahat ng request ay dumadaan sa server mo na may permission check
• Nasa system prompt ang mga patakaran; puwedeng i-configure ang model ID
• Naitakda ang max_tokens kada feature; naka-stream ang mahahabang sagot
• May limitasyon kada user sa app mo
• Nahahawakan ang 429 at 529 gamit ang backoff; naitatala ang request ID
• Magiliw na error state na hindi sumisira sa pahina
• Nasubukan gamit ang walang laman, napakahaba, at mapanganib na input

Paggamit ng Claude API sa Mythex

Sa mga app na binubuo mo sa Mythex, ginagamit ng mga feature ng Claude ang sarili mong Anthropic key at sinisingil sa sarili mong Anthropic account, hindi sa build credits ng Mythex. Hiwalay ito sa Mythex agent na sumusulat ng code mo. Idagdag ang ANTHROPIC_API_KEY bilang project secret sa pamamagitan ng /secrets, project settings, o secrets card sa chat, pagkatapos ay ilarawan ang feature gamit ang mga prompt na tulad ng nasa itaas. I-publish ulit kapag nagpalit ng secret sa live na app. Tingnan ang Magdagdag ng AI features gamit ang sarili mong API key para sa starter prompt. Kung pumipili ka sa pagitan ng mga provider, sakop ng paano i-integrate ang OpenAI API ang parehong paksa para sa OpenAI.

Mga tanong