Kaip integruoti Claude API į savo programėlę

Norėdami integruoti Claude API, sukurkite API raktą Anthropic Claude Console, laikykite jį kaip serverio pusės paslaptį (paprastai ANTHROPIC_API_KEY) ir kvieskite Messages API iš savo serverio maršruto naudodami vieną iš oficialių Anthropic SDK. Kiekviena užklausa nurodo model, nustato max_tokens (ilgiausią atsakymą, kurį priimate) ir siunčia pokalbį kaip messages, o jūsų instrukcijos eina atskirame system pranešime. Nustatykite išlaidų ribą, srautiniu būdu perduokite ilgus atsakymus ir apdorokite greičio ribos (429) bei perkrovos (529) klaidas bandydami dar kartą.

Šis vadovas apima paruošimą, saugų užklausų srautą, raginimus DI kūrėjui ir klaidas, kurių reikia tikėtis. Anthropic informacija paimta iš jų dokumentacijos nuo 2026 m. rugsėjo. Bendrai apie tai, kaip veikia žetonai ir kainodara, žr. kaip naudoti LLM API.

Ką su juo galite sukurti

• Pokalbių asistentus ir pagalbos langelius (kaip sukurti DI pokalbių roboto programėlę)
• Santraukas, perrašymus ir parengtus atsakymus
• Laukų ištraukimą iš dokumentų, el. laiškų ir formų
• Atsakymus į klausimus remiantis jūsų pačių turiniu
• Agentus, kurie kviečia jūsų programėlės funkcijas per įrankių naudojimą

Daugiau idėjų rasite kaip pridėti DI funkcijų į savo programėlę.

Messages API trumpai

Pagal Anthropic API nuorodą užklausa yra POST į https://api.anthropic.com/v1/messages su:

API yra be būsenos: norėdami tęsti pokalbį, kiekvienoje užklausoje siųskite ankstesnius ėjimus iš naujo. Todėl ilgi pokalbiai kainuoja daugiau už kiekvieną žinutę.

Anthropic skelbia oficialius SDK Python, TypeScript, C#, Go, Java, PHP ir Ruby kalboms. Jie nustato antraštes, apdoroja atsakymus ir palaiko srautinį perdavimą. Naudokite vieną iš jų, o ne žaliąjį HTTP, nebent turite priežastį to nedaryti.

Modelio pasirinkimas

Anthropic siūlo kelis Claude modelius, kurie keičia galimybes į greitį ir kainą, o modelių sąrašas keičiasi. Pasirinkite mažiausią modelį, kuris gerai atlieka jūsų užduotį, išbandykite jį su tikrais pavyzdžiais ir laikykite modelio ID konfigūracijoje, kad galėtumėte perjungti be kodo keitimo. Dabartinių variantų ir kainų ieškokite Anthropic modelių ir kainodaros puslapiuose.

Paskyros paruošimas

1. Prisijunkite prie Claude Console adresu platform.claude.com ir pridėkite apmokėjimą.
2. Sukurkite API raktą. Turėkite po vieną raktą kiekvienai aplinkai (testavimui ir produkcijai), kad galėtumėte panaikinti vieną nepažeisdami kito.
3. Nustatykite išlaidų ribą. Anthropic klaidų puslapyje nurodyta, kad kai naudojimas pasiekia jūsų nustatytą išlaidų ribą, API grąžina 400 klaidą, todėl jūsų programėlė turėtų rodyti aiškų pranešimą tokiu atveju.
4. Peržiūrėkite greičio ribas savo paskyrai Console; jos matuojamos pagal organizaciją.

Užklausos srautas

1. Naudotojas veikia jūsų programėlėje: išsiunčia žinutę, paspaudžia „Apibendrinti“.
2. Naršyklė kreipiasi į jūsų serverio maršrutą, niekada tiesiogiai į Anthropic.
3. Jūsų serveris patikrina, ar naudotojas prisijungęs ir turi teisę naudoti funkciją, ir taiko vienam naudotojui skirtą ribą.
4. Jis sudaro užklausą: sisteminę instrukciją su jūsų taisyklėmis, naudotojo įvestį ir visus duomenis iš jūsų duomenų bazės, kuriuos užduočiai reikia.
5. Jis kviečia Messages API su raktu iš aplinkos ir protingu max_tokens.
6. Jis perduoda atsakymą naršyklei srautu ir įrašo žetonų naudojimą iš atsakymo.

Parinktys ir kompromisai

Raginimai jūsų DI kūrėjui

Pirmoji funkcija:

Pridėkite skydelį „Klauskite apie šį dokumentą“. Jis kviečia serverio maršrutą POST /api/ask, kuris patikrina, ar naudotojas prisijungęs ir yra dokumento savininkas, tada kviečia Claude Messages API naudodamas oficialų Anthropic SDK ir paslaptį ANTHROPIC_API_KEY. Modelio ID nuskaitykite iš paslapties CLAUDE_MODEL. Sisteminė instrukcija: „Atsakykite tik remdamiesi pateiktu dokumentu. Jei atsakymo jame nėra, pasakykite tai.“ Siųskite dokumento tekstą ir klausimą, nustatykite max_tokens į 800, srautu rodykite atsakymą puslapyje ir niekada neatskleiskite rakto naršyklei.

Apsaugos priemonės ir klaidos:

Apribokite kiekvieną naudotoją iki 20 klausimų per valandą, sekdami duomenų bazėje. Įrašykite kiekvienos atsakymo įvesties ir išvesties žetonus su naudotojo ID ir užklausos ID. Gavus 429 arba 529 klaidas, bandykite dar kartą su eksponentiniu atidėjimu iki 3 kartų, paisydami retry-after antraštės, tada rodykite „Asistentas užimtas, bandykite netrukus.“ Jei API praneša apie išlaidų ribos klaidą, rodykite „DI funkcijos sustabdytos“ ir įspėkite administratorių.

Klaidos, kurių reikia tikėtis

Pagal Anthropic klaidų dokumentaciją, tokios klaidos su kuriomis jūsų programėlė tikrai susidurs:

Anthropic dokumentacijoje teigiama, kad oficialūs SDK automatiškai kartoja laikinas nesėkmes (ryšio klaidas, greičio ribas ir 5xx klaidas) du kartus pagal numatytuosius nustatymus su eksponentiniu atidėjimu, ir tai galima konfigūruoti. Kiekvienas atsakymas turi request-id antraštę; įrašykite ją, kad palaikymo komanda galėtų atsekti problemas.

Dažnos klaidos

• API kvietimas iš naršyklės. Jūsų raktas tampa viešas. Visada eikite per savo serverį. Žr. kaip saugoti API raktus.
• Pamiršti, kad max_tokens yra riba, o ne tikslas. Nustatykite pagal tai, ko reikia funkcijai; per mažas nukerta atsakymus, per didelis rizikuoja ilgais, brangiais atsakymais.
• Taisyklių dėjimas į naudotojo žinutę. Pastovios instrukcijos priklauso system pranešimui; leidimai priklauso jūsų kodui.
• Visada siunčiamas visas pokalbis. Kai pokalbiai auga, apkarpykite arba apibendrinkite senus ėjimus.
• Nėra išlaidų ribos ar vienam naudotojui skirtos ribos.
• Modelio ID įrašymas tiesiai į kodą. Modeliai atnaujinami ir išimami iš naudojimo.
• Stop priežasties ignoravimas. Jei atsakymas sustojo, nes pasiekė max_tokens, pasakykite naudotojui arba padidinkite ribą.

Kontrolinis sąrašas

• API raktas sukurtas Claude Console ir laikomas kaip serverio pusės paslaptis
• Atskiri raktai testavimui ir produkcijai
• Nustatyta išlaidų riba; aiškus pranešimas, kai ji pasiekiama
• Visos užklausos eina per jūsų serverį su leidimų tikrinimu
• Sisteminė instrukcija saugo taisykles; modelio ID konfigūruojamas
• max_tokens nustatytas kiekvienai funkcijai; ilgi atsakymai perduodami srautu
• Vienam naudotojui skirta greičio riba jūsų programėlėje
• 429 ir 529 apdorojami su atidėjimu; užklausų ID įrašomi
• Draugiška klaidos būsena, kuri nesugadina puslapio
• Išbandyta su tuščiomis, labai ilgomis ir priešiškomis įvestimis

Claude API naudojimas Mythex

Programėlėse, kurias kuriate Mythex, Claude funkcijos naudoja jūsų pačių Anthropic raktą ir yra apmokestinamos jūsų Anthropic paskyroje, o ne Mythex kūrimo kreditais. Tai atskira nuo Mythex agento, kuris rašo jūsų kodą. Pridėkite ANTHROPIC_API_KEY kaip projekto paslaptį per /secrets, projekto nustatymus arba paslapčių kortelę pokalbyje, tada aprašykite funkciją naudodami aukščiau pateiktus raginimus. Po paslapčių pakeitimo gyvoje programėlėje paskelbkite iš naujo. Pradinį raginimą rasite Pridėkite DI funkcijas su savo API raktais. Jei renkatės tarp tiekėjų, kaip integruoti OpenAI API aptaria tą patį OpenAI atveju.

Klausimai