Näin liität Claude API:n sovellukseesi

Kun liität Claude API:n, luo API-avain Anthropicin Claude Consolessa, tallenna se palvelinpuolen salaisuutena (yleensä ANTHROPIC_API_KEY) ja kutsu Messages API:a oman palvelimesi reitiltä jollakin Anthropicin virallisista SDK:istä. Jokainen pyyntö nimeää mallin, asettaa max_tokens-arvon (pisimmän vastauksen, jonka hyväksyt) ja lähettää keskustelun messages-kenttänä, ja ohjeet menevät erilliseen system-kehotteeseen. Aseta kuluraja, suoratoista pitkät vastaukset ja käsittele nopeusrajoitus- (429) ja ylikuormitusvirheet (529) uudelleenyrityksillä.

Tämä opas kattaa asetukset, turvallisen pyyntövirran, kehotteet tekoälyrakentajalle ja virheet, joihin pitää varautua. Anthropicin tiedot perustuvat sen dokumentaatioon syyskuulta 2026. Tokenien ja hinnoittelun yleiskuvaus löytyy sivulta näin käytät LLM-rajapintoja.

Mitä sillä voi rakentaa

Keskusteluavustajia ja ohjeikkunoita (näin rakennat tekoälychatbot-sovelluksen)
Tiivistelmiä, uudelleenmuotoiluja ja luonnoksia vastauksista
Kenttien poimimista asiakirjoista, sähköposteista ja lomakkeista
Vastauksia omasta sisällöstäsi
Agentteja, jotka kutsuvat sovelluksesi funktioita työkalukäytön kautta

Lisää ideoita löytyy sivulta näin lisäät tekoälyominaisuuksia sovellukseesi.

Messages API lyhyesti

Anthropicin API-viitteen mukaan pyyntö on POST-kutsu osoitteeseen https://api.anthropic.com/v1/messages, ja siinä on:

Osa	Mitä se on
`x-api-key`-otsikko	API-avaimesi
`anthropic-version`-otsikko	API-version, esimerkiksi `2023-06-01`
`model` (pakollinen)	Mikä Claude-malli otetaan käyttöön
`max_tokens` (pakollinen)	Suurin määrä tokeneita, jonka vastaus saa sisältää; malli voi pysähtyä aiemmin
`messages` (pakollinen)	Keskustelu: vuorottelevat `user`- ja `assistant`-vuorot
`system` (valinnainen)	Ohjeet, jotka koskevat koko keskustelua
`stream` (valinnainen)	Aseta arvoksi `true`, jotta vastaus tulee kirjoittamisen aikana palvelimelta lähetettyinä tapahtumina

Rajapinta on tilaton: jatkaaksesi keskustelua lähetät aiemmat vuorot uudelleen jokaisessa pyynnössä. Siksi pitkät keskustelut maksavat enemmän jokaisesta viestistä.

Anthropic julkaisee viralliset SDK:t Pythonille, TypeScriptille, C#:lle, Golle, Javalle, PHP:lle ja Rubylle. Ne asettavat otsikot, jäsentävät vastaukset ja tukevat suoratoistoa. Käytä niitä raa'an HTTP:n sijaan, ellei sinulla ole erityistä syytä.

Mallin valinta

Anthropic tarjoaa useita Claude-malleja, jotka vaihtavat kyvykkyyttä nopeuteen ja hintaan, ja valikoima muuttuu. Valitse pienin malli, joka hoitaa tehtäväsi hyvin, testaa sitä oikeilla esimerkeillä ja pidä mallin tunniste asetuksissa, jotta voit vaihtaa sen ilman koodimuutosta. Tarkista Anthropicin malli- ja hinnoitteluSivut ajantasaisia vaihtoehtoja ja hintoja varten.

Tilin määrittäminen

Kirjaudu Claude Consoleen osoitteessa platform.claude.com ja lisää laskutustiedot.
Luo API-avain. Pidä erillinen avain jokaisessa ympäristössä (testaus ja tuotanto), jotta voit peruuttaa yhden rikkomatta toista.
Aseta kulujen raja. Anthropicin virhesivun mukaan kun käyttö saavuttaa asettamasi kulurajan, API palauttaa 400-virheen. Sovelluksesi pitää näyttää siinä tilanteessa selkeä viesti.
Tarkista nopeusrajoitukset tililläsi Consolessa. Ne mitataan organisaatiokohtaisesti.

Pyyntövirta

Käyttäjä toimii sovelluksessasi: lähettää viestin tai klikkaa "Tiivistä".
Selain kutsuu sinun palvelinreittiäsi, ei koskaan suoraan Anthropicia.
Palvelimesi tarkistaa, että käyttäjä on kirjautunut ja saa käyttää ominaisuutta, ja soveltaa käyttäjäkohtaista rajaa.
Se rakentaa pyynnön: järjestelmäkehotteen sääntöineen, käyttäjän syötteen ja tehtävän tarvitsemat tiedot tietokannastasi.
Se kutsuu Messages API:a ympäristömuuttujan avaimella ja järkevällä max_tokens-arvolla.
Se suoratoistaa vastauksen selaimeen ja kirjaa tokenien käytön vastauksesta.

Vaihtoehdot ja kompromissit

Päätös	Yksinkertainen valinta	Milloin mennä pidemmälle
Suoratoisto	Odota koko vastaus	Suoratoista chatissa ja kaikessa pitkässä; Anthropic suosittelee suoratoistoa tai eräajoja pitkäkestoisiin pyyntöihin
Tulosteen muoto	Pelkkä teksti	Jäsennelty JSON-tuloste, kun koodisi tarvitsee lukea kenttiä
Datasi	Sisällytä asiaankuuluva tietue	Haku omasta sisällöstäsi, kun sitä on liikaa (mikä RAG on)
Toimenpiteet	Malli kirjoittaa vain tekstiä	Työkalukäyttö, jossa malli pyytää koodiasi suorittamaan määrittelemäsi funktion
Massatyö, ei kiireellinen	Käy kohteet läpi silmukassa	Message Batches API, jolle lähetät työn ja kysyt tuloksia myöhemmin

Kehotteet tekoälyrakentajalle

Ensimmäinen ominaisuus:

Lisää paneeli "Kysy tästä asiakirjasta". Se kutsuu palvelinreittiä POST /api/ask, joka tarkistaa, että käyttäjä on kirjautunut ja omistaa asiakirjan, ja kutsuu sitten Claude Messages API:a virallisella Anthropic SDK:lla ja salaisuudella ANTHROPIC_API_KEY. Lue mallin tunniste salaisuudesta CLAUDE_MODEL. Järjestelmäkehote: "Vastaa vain annetusta asiakirjasta. Jos vastausta ei ole siinä, sano se." Lähetä asiakirjan teksti ja kysymys, aseta max_tokens-arvoksi 800, suoratoista vastaus sivulle, äläkä koskaan paljasta avainta selaimelle.

Suojaukset ja virheet:

Rajoita jokaisen käyttäjän kysymykset 20 kysymykseen tunnissa, seurattuna tietokannassa. Kirjaa jokaisesta vastauksesta syöte- ja tulostokenit käyttäjän ID:n ja pyynnön ID:n kanssa. Virheissä 429 tai 529 yritä uudelleen eksponentiaalisella viiveellä enintään kolme kertaa, kunnioita retry-after-otsikkoa ja näytä sitten "Avustaja on varattu, yritä pian uudelleen." Jos API ilmoittaa kulurajan ylittymisestä, näytä "Tekoälyominaisuudet on keskeytetty" ja hälytä ylläpitäjälle.

Virheet, joihin pitää varautua

Anthropicin virhedokumentaatiosta, ne joihin sovelluksesi todellisuudessa törmää:

Koodi	Tyyppi	Mitä tehdä
400	`invalid_request_error`	Korjaa pyyntö; palautuu myös, kun ylität asettamasi kulurajan
401	`authentication_error`	Tarkista, että avain on olemassa, oikein ja ettei sitä ole peruutettu
413	`request_too_large`	Lähetä vähemmän; Messages API hyväksyy enintään 32 Mt pyyntöä kohden
429	`rate_limit_error`	Odota ja yritä uudelleen, kunnioita `retry-after`-arvoa
500	`api_error`	Yritä uudelleen viiveellä; jos ongelma jatkuu, ota yhteyttä tukeen pyynnön ID:llä
529	`overloaded_error`	Hetkellinen korkea liikenne kaikille käyttäjille; odota ja yritä uudelleen

Anthropicin dokumentaation mukaan viralliset SDK:t yrittävät automaattisesti uudelleen ohimeneviä virheitä (yhteysvirheet, nopeusrajoitukset ja 5xx-virheet) oletuksena kaksi kertaa eksponentiaalisella viiveellä, ja tätä voi säätää. Jokaisessa vastauksessa on request-id-otsikko. Kirjaa se, jotta tuki voi jäljittää ongelmat.

Yleisiä virheitä

Kutsut API:a selaimesta. Avaimesi tulee silloin julkiseksi. Kulje aina palvelimesi kautta. Katso näin pidät API-avaimet turvassa.
Unohdetaan, että max_tokens on katto, ei tavoite. Aseta se ominaisuuden tarpeen mukaan: liian matala katkaisee vastaukset, liian korkea altistaa pitkille ja kalliille vastauksille.
Sääntöjen laittaminen käyttäjäviestiin. Pysyvät ohjeet kuuluvat system-kehotteeseen, oikeudet kuuluvat koodiisi.
Koko chatin lähettäminen ikuisesti. Lyhennä tai tiivistä vanhat vuorot keskustelujen kasvaessa.
Ei kulurajaa eikä käyttäjäkohtaista rajaa.
Mallin tunnisteen kovakoodaaminen. Mallit päivittyvät ja poistuvat käytöstä.
Pysähtymissyyn sivuuttaminen. Jos vastaus pysähtyi, koska se saavutti max_tokens-rajan, kerro käyttäjälle tai nosta rajaa.

Tarkistuslista

API-avain luotu Claude Consolessa ja tallennettu palvelinpuolen salaisuutena
Erilliset avaimet testaukseen ja tuotantoon
Kulujen raja asetettu; selkeä viesti, kun raja saavutetaan
Kaikki pyynnöt kulkevat palvelimesi kautta oikeustarkistuksilla
Järjestelmäkehote sisältää säännöt; mallin tunniste on säädettävissä
max_tokens asetettu ominaisuuskohtaisesti; pitkät vastaukset suoratoistetaan
Käyttäjäkohtainen nopeusraja sovelluksessasi
429 ja 529 käsitelty viiveellä; pyynnön ID:t kirjataan
Ystävällinen virhetila, joka ei ririko sivua
Testattu tyhjillä, erittäin pitkillä ja vihamielisillä syötteillä

Claude API:n käyttö Mythexissä

Mythexillä rakentamissasi sovelluksissa Clauden ominaisuudet käyttävät omaa Anthropic-avaintasi, ja ne laskutetaan Anthropic-tililtäsi, eivät Mythexin rakennusluotoilla. Tämä on erillään Mythex-agentista, joka kirjoittaa koodisi. Lisää ANTHROPIC_API_KEY projektin salaisuudeksi kohdassa /secrets, projektin asetuksissa tai chatin salaisuuskortissa ja kuvaile ominaisuus yllä olevien kaltaisilla kehotteilla. Julkaise uudelleen, kun muutat salaisuuksia käytössä olevassa sovelluksessa. Aloituskehotteen löydät kohdasta Lisää tekoälyominaisuudet omilla API-avaimillasi. Jos vertailet palveluntarjoajia, sivu näin liität OpenAI API:n käsittelee saman asian OpenAI:n kohdalta.

Kysymykset

Miten saan Claude API -avaimen?

Kirjaudu Claude Consoleen osoitteessa platform.claude.com, aseta laskutus ja luo API-avain. Tallenna se palvelinpuolen salaisuutena, yleisesti nimellä ANTHROPIC_API_KEY, äläkä koskaan laita sitä selaimen koodiin.

Mitä Claude API:n pyyntö tarvitsee?

Syyskuusta 2026 alkaen Anthropicin Messages API -viitteessä luetellaan kolme pakollista kenttää: model, max_tokens ja messages. Suorat HTTP-kutsut tarvitsevat lisäksi otsikot x-api-key ja anthropic-version. Viralliset SDK:t asettavat ne puolestasi.

Mitä 529-virhe tarkoittaa Claude API:ssa?

Anthropicin virhesivu kuvaa 529-virheen tyypiksi overloaded_error: API on hetkellisesti ylikuormittunut kaikkien käyttäjien suuren liikenteen takia. Yritä uudelleen eksponentiaalisella viiveellä. Viralliset SDK:t yrittävät automaattisesti uudelleen joitakin ohimeneviä virheitä.

Voinko käyttää Claudea koodilla, joka on kirjoitettu OpenAI SDK:lle?

Anthropic dokumentoi OpenAI SDK -yhteensopivuuskerroksen, jolla Claudea voi käyttää OpenAI SDK:n rajapinnan kautta. Uudessa koodissa sen omat SDK:t antavat pääsyn Claudelle ominaisiin toimintoihin, joten ne ovat yleensä parempi lähtökohta.