Kā integrēt Claude API savā lietotnē

Lai integrētu Claude API, izveidojiet API atslēgu Anthropic Claude Console, saglabājiet to kā servera puses noslēpumu (parasti ANTHROPIC_API_KEY) un izsauciet Messages API no maršruta jūsu pašu serverī, izmantojot vienu no Anthropic oficiālajiem SDK. Katrs pieprasījums nosauc modeli, iestata max_tokens (garāko atbildi, ko pieņemsiet) un sūta sarunu kā messages, bet jūsu norādījumi atrodas atsevišķā system uzvednē. Iestatiet izdevumu limitu, straumējiet garas atbildes un apstrādājiet ierobežojumu (429) un pārslodzes (529) kļūdas ar atkārtotiem mēģinājumiem.

Šis ceļvedis aptver iestatīšanu, drošu pieprasījuma plūsmu, uzvednes AI veidotājam un kļūdas, kurām jāgatavojas. Anthropic dati ir no tās dokumentācijas uz 2026. gada septembri. Par to, kā darbojas marķieri un cenas vispār, skatiet kā izmantot LLM API.

Ko ar to var veidot

• Tērzēšanas asistentus un palīdzības logrīkus (kā izveidot AI tērzēšanas robota lietotni)
• Kopsavilkumus, pārrakstīšanu un atbilžu uzmetumus
• Lauku izvilkšanu no dokumentiem, e-pastiem un formām
• Atbilžu sniegšanu uz jautājumiem par jūsu pašu saturu
• Aģentus, kas izsauc jūsu lietotnes funkcijas, izmantojot rīku lietošanu

Vairāk idejų skatiet kā pievienot AI funkcijas savai lietotnei.

Messages API īsumā

Saskaņā ar Anthropic API atsauci pieprasījums ir POST uz https://api.anthropic.com/v1/messages ar:

API nav stāvokļa: lai turpinātu sarunu, katrā pieprasījumā jānosūta iepriekšējie pagrieziena. Tāpēc garas sarunas katrs ziņojums maksā vairāk.

Anthropic publicē oficiālos SDK Python, TypeScript, C#, Go, Java, PHP un Ruby valodām. Tie iestata galvenes, apstrādā atbildes un atbalsta straumēšanu. Izmantojiet tos, nevis tīro HTTP, ja vien nav konkrēta iemesla.

Modeļa izvēle

Anthropic piedāvā vairākus Claude modeļus, kas līdzsvaro spēju, ātrumu un cenu, un klāsts laika gaitā mainās. Izvēlieties mazāko modeli, kas jūsu uzdevumu labi veic, pārbaudiet to uz reāliem piemēriem un glabājiet modeļa ID konfigurācijā, lai varētu mainīt to bez koda izmaiņām. Aktuālās iespējas un likmes skatiet Anthropic modeļu un cenu lapās.

Konta iestatīšana

1. Pierakstieties Claude Console vietnē platform.claude.com un pievienojiet norēķinus.
2. Izveidojiet API atslēgu. Katrai videi (testēšanai un ražošanai) turiet atsevišķu atslēgu, lai vienu varētu atsaukt, neizjaucot otru.
3. Iestatiet izdevumu limitu. Anthropic kļūdu lapā norādīts, ka, sasniedzot jūsu iestatīto izdevumu limitu, API atgriež 400 kļūdu, tāpēc lietotnei jārāda skaidrs paziņojums.
4. Pārskatiet ātruma limitus savam kontam Console vidē; tie tiek mērīti pa organizācijām.

Pieprasījuma plūsma

1. Lietotājs darbojas jūsu lietotnē: nosūta ziņu, noklikšķina uz „Apkopot“.
2. Pārlūks izsauc jūsu serveri, nekad tieši Anthropic.
3. Jūsu serveris pārbauda, vai lietotājs ir pieteicies un drīkst izmantot funkciju, un piemēro lietotāja ierobežojumu.
4. Tas veido pieprasījumu: sistēmas uzvedni ar jūsu noteikumiem, lietotāja ievadi un datus no datubāzes, kas uzdevumam nepieciešami.
5. Tas izsauc Messages API ar atslēgu no vides un saprātīgu max_tokens.
6. Tas straumē atbildi pārlūkā un reģistrē marķieru lietojumu no atbildes.

Iespējas un kompromisi

Uzvednes, ko dot AI veidotājam

Pirmā funkcija:

Pievienojiet paneli „Jautāt par šo dokumentu“. Tas izsauc servera maršrutu POST /api/ask, kas pārbauda, vai lietotājs ir pieteicies un ir šī dokumenta īpašnieks, un pēc tam izsauc Claude Messages API ar oficiālo Anthropic SDK un noslēpumu ANTHROPIC_API_KEY. Modeļa ID nolasiet no noslēpuma CLAUDE_MODEL. Sistēmas uzvedne: „Atbildi tikai no sniegtā dokumenta. Ja atbildes tajā nav, pasaki to.“ Sūti dokumenta tekstu un jautājumu, iestati max_tokens uz 800, straumē atbildi lapā un nekad neatklāj atslēgu pārlūkam.

Kļūdas un ierobežojumi:

Ierobežojiet katram lietotājam 20 jautājumus stundā, glabājot to datubāzē. Katram pieprasījumam reģistrējiet ievades un izvades marķierus kopā ar lietotāja ID un pieprasījuma ID. Kļūdu 429 vai 529 gadījumā mēģiniet vēlreiz ar eksponenciālu aizkavi līdz 3 reizēm, ievērojot retry-after galveni, un pēc tam parādiet „Asistents ir aizņemts, mēģiniet drīz vēlreiz“. Ja API ziņo par izdevumu limita kļūdu, parādiet „AI funkcijas ir apturētas“ un brīdiniet administratoru.

Kļūdas, kurām jāgatavojas

No Anthropic kļūdu dokumentācijas — tās, ar kurām lietotne patiešām saskarsies:

Anthropic dokumentācija saka, ka oficiālie SDK automātiski atkārto pārejošas kļūmes (savienojuma kļūdas, ātruma ierobežojumus un 5xx kļūdas) pēc noklusējuma divas reizes ar eksponenciālu aizkavi, un to var konfigurēt. Katrā atbildē ir galvene request-id; reģistrējiet to, lai atbalsts varētu izsekot problēmām.

Biežākās kļūdas

• Claude API izsaukšana no pārlūka. Jūsu atslēga kļūst publiska. Vienmēr ejiet caur savu serveri. Skatiet kā glabāt API atslēgas drošībā.
• Aizmirst, ka max_tokens ir ierobežojums, nevis mērķis. Iestatiet to atbilstoši funkcijai; pārāk zems saīsina atbildes, pārāk augsts rada garas, dārgas atbildes.
• Noteikumu ievietošana lietotāja ziņojumā. Pastāvīgie norādījumi pieder system uzvednei; atļaujas pieder jūsu kodam.
• Visas sarunas sūtīšana mūžīgi. Samaziniet vai apkopojiet vecos pagriezienus, kad sarunas aug.
• Nav izdevumu limita vai lietotāja ierobežojuma.
• Modeļa ID ievietošana kodā. Modeļi tiek atjaunināti un izņemti no lietošanas.
• Apstāšanās iemesla ignorēšana. Ja atbilde apstājās, sasniedzot max_tokens, paziņojiet to lietotājam vai palieliniet ierobežojumu.

Kontrolsaraksts

• API atslēga izveidota Claude Console un saglabāta kā servera puses noslēpums
• Atsevišķas atslēgas testēšanai un ražošanai
• Izdevumu limits iestatīts; skaidrs paziņojums, kad tas sasniegts
• Visi pieprasījumi iet caur jūsu serveri ar atļauju pārbaudēm
• Sistēmas uzvednē ir noteikumi; modeļa ID ir konfigurējams
• max_tokens iestatīts katrai funkcijai; garas atbildes straumētas
• Lietotāja ātruma ierobežojums jūsu lietotnē
• 429 un 529 apstrādāti ar aizkavi; pieprasījumu ID reģistrēti
• Draudzīgs kļūdas stāvoklis, kas nesabojā lapu
• Pārbaudīts ar tukšām, ļoti garām un naidīgām ievadēm

Claude API izmantošana Mythex

Lietotnēs, ko veidojat Mythex, Claude funkcijas izmanto jūsu pašu Anthropic atslēgu, un maksa tiek iekasēta jūsu Anthropic kontā, nevis no Mythex veidošanas kredītiem. Tas ir atsevišķi no Mythex aģenta, kas raksta jūsu kodu. Pievienojiet ANTHROPIC_API_KEY kā projekta noslēpumu caur /secrets, projekta iestatījumiem vai noslēpumu kartīti čatā, un pēc tam aprakstiet funkciju ar uzvednēm, līdzīgām iepriekš minētajām. Pēc noslēpumu maiņas publicētā lietotnē publicējiet vēlreiz. Sākuma uzvedni skatiet Pievienot AI funkcijas ar saviem API atslēgām. Ja izvēlaties starp pakalpojumu sniedzējiem, kā integrēt OpenAI API aptver to pašu jautājumu OpenAI gadījumā.

Jautājumi