Hvernig þú tengir Claude API við appið þitt

Til að tengja Claude API skaltu búa til API-lykil í Claude Console hjá Anthropic, geyma hann sem leyndarmál á netþjóni (venjulega ANTHROPIC_API_KEY) og kalla á Messages API frá leið á þínum eigin netþjóni með einu af opinberu SDK-um Anthropic. Hver beiðni nefnir líkan, setur max_tokens (lengsta svar sem þú samþykkir) og sendir samtalið sem messages, með fyrirmælunum þínum í sérstöku system-kerfisfyrirmæli. Settu eyðslumörk, streymdu löngum svörum og meðhöndlaðu villur vegna hraðatakmarkana (429) og ofhleðslu (529) með endurtilraunum.

Þessi leiðbeining fjallar um uppsetningu, örugga beiðnaflæðið, fyrirmæli fyrir AI-smiði og villurnar sem þú þarft að gera ráð fyrir. Upplýsingar um Anthropic eru úr skjölunum þeirra frá september 2026. Fyrir hvernig tákn og verðlagning virka almennt, sjá hvernig þú notar LLM API.

Það sem þú getur smíðað með þessu

• Spjallaðstoðarmenn og hjálparglugga (hvernig þú smíðar AI-spjallmenni)
• Samantektir, endurskrif og drög að svörum
• Að draga reiti úr skjölum, tölvupósti og eyðublöðum
• Að svara spurningum út frá þínu eigin efni
• Agenta sem kalla á föll í appinu þínu í gegnum tólanotkun

Fleiri hugmyndir: hvernig þú bætir AI-eiginleikum við appið þitt.

Messages API í stuttu máli

Samkvæmt API-viðmiðunarhandbók Anthropic er beiðni POST á https://api.anthropic.com/v1/messages með:

API-ið er án minnis: til að halda áfram samtali þarftu að senda fyrri umferðir aftur með hverri beiðni. Þess vegna kostar löng spjall meira fyrir hvert skilaboð.

Anthropic gefur út opinber SDK fyrir Python, TypeScript, C#, Go, Java, PHP og Ruby. Þau setja hausana, þátta svörin og styðja streymi. Notaðu eitt þeirra í stað hrárrar HTTP-beiðni nema þú hafir sérstaka ástæðu.

Að velja líkan

Anthropic býður upp á nokkur Claude-líkön sem skiptast á getu, hraða og verði, og úrvalið breytist. Veldu minnsta líkanið sem sinnir verkefninu þínu vel, prófaðu það á raunverulegum dæmum og geymdu líkanaauðkennið í stillingum svo þú getir skipt án kóðabreytinga. Skoðaðu verðlagnings- og líkanasíður Anthropic fyrir núverandi valkosti og gjöld.

Uppsetning reiknings

1. Skráðu þig inn í Claude Console á platform.claude.com og bættu við greiðslum.
2. Búðu til API-lykil. Hafðu einn lykil fyrir hvert umhverfi (prófun og framleiðslu) svo þú getir afturkallað einn án þess að brjóta hinn.
3. Settu eyðslumörk. Villusíða Anthropic bendir á að þegar notkun nær eyðslumörkum sem þú hefur sett skilar API-ið 400-villu, svo appið þitt ætti að sýna skýr skilaboð þegar það gerist.
4. Skoðaðu hraðatakmarkanir fyrir reikninginn þinn í Console; þær eru mældar fyrir hverja stofnun.

Beiðnaflæðið

1. Notandinn gerir eitthvað í appinu þínu: sendir skilaboð, smellir á „Taka saman“.
2. Vafrinn kallar á þína leið á netþjóninum, aldrei beint á Anthropic.
3. Netþjónninn athugar að notandinn sé innskráður og megi nota eiginleikann og beitir takmörkun á hvern notanda.
4. Hann setur saman beiðnina: kerfisfyrirmæli með þínum reglum, inntak notandans og þau gögn sem verkefnið þarf úr gagnagrunninum þínum.
5. Hann kallar á Messages API með lyklinum úr umhverfinu og skynsamlegu max_tokens.
6. Hann streymir svarinu til vafrans og skráir notkun tákna úr svarinu.

Valkostir og málamiðlanir

Fyrirmæli fyrir AI-smiðinn þinn

Fyrsti eiginleiki:

Bættu við spjaldinu „Spyrja um þetta skjal“. Það kallar á netþjónsleiðina POST /api/ask sem athugar að notandinn sé innskráður og eigi skjalið, og kallar síðan á Claude Messages API með opinbera Anthropic SDK-inu og leyndarmálinu ANTHROPIC_API_KEY. Lestu líkanaauðkennið úr leyndarmálinu CLAUDE_MODEL. Kerfisfyrirmæli: „Svaraðu aðeins út frá skjalinu sem er gefið. Ef svarið er ekki í því, segðu það.“ Sendu texta skjalsins og spurninguna, stilltu max_tokens á 800, streymdu svarinu á síðuna og láttu lykilinn aldrei ná vafranum.

Varnir og villur:

Takmarkaðu hvern notanda við 20 spurningar á klukkustund, skráð í gagnagrunninum. Skráðu inntaks- og úttakstákn úr hverju svari ásamt notandaauðkenninu og beiðnaauðkenninu. Við 429- eða 529-villur, reyndu aftur með veldisvaxandi bið allt að 3 sinnum, og virtu retry-after hausinn ef hann er til staðar. Sýndu síðan „Aðstoðarmaðurinn er upptekinn, reyndu aftur fljótlega.“ Ef API-ið segir að eyðslumörkum hafi verið náð, sýndu „AI-eiginleikar eru í bið“ og láttu stjórnanda vita.

Villur sem þú þarft að gera ráð fyrir

Úr villuskjölum Anthropic, þær sem appið þitt mun raunverulega lenda í:

Skjöl Anthropic segja að opinberu SDK-in endurreyni sjálfkrafa tímabundnar villur (tengingarvillur, hraðatakmarkanir og 5xx-villur) tvisvar sinnum sjálfgefið með veldisvaxandi bið, og þú getur stillt það. Hvert svar ber request-id haus; skráðu hann svo stuðningurinn geti rakið vandamál.

Algeng mistök

• Að kalla á API-ið úr vafranum. Lykillinn verður opinber. Farðu alltaf í gegnum þinn eigin netþjón. Sjá hvernig þú heldur API-lyklum öruggum.
• Að gleyma að max_tokens er þak, ekki markmið. Stilltu það á það sem eiginleikinn þarf; of lágt sker svörin, of hátt eykur hættu á löngum, dýrum svörum.
• Að setja reglur í skilaboð notandans. Fastar leiðbeiningar eiga heima í system-kerfisfyrirmælunum; heimildir eiga heima í kóðanum þínum.
• Að senda allt spjallið að eilífu. Styttu eða taktu saman eldri umferðir eftir því sem samtöl lengjast.
• Engin eyðslumörk eða þak á hvern notanda.
• Að harðkóða líkanaauðkenni. Líkön eru uppfærð og aflögð.
• Að hunsa stöðvunarástæðuna. Ef svarið stöðvaðist vegna þess að það náði max_tokens, segðu notandanum það eða hækkaðu þakið.

Gátlisti

• API-lykill búinn til í Claude Console og geymdur sem leyndarmál á netþjóni
• Aðskildir lyklar fyrir prófun og framleiðslu
• Eyðslumörk sett; skýr skilaboð þegar þeim er náð
• Allar beiðnir fara í gegnum þinn netþjón með heimildaathugunum
• Kerfisfyrirmælin geyma reglurnar; líkanaauðkennið er stillanlegt
• max_tokens stillt fyrir hvern eiginleika; löng svör streymd
• Takmörkun á hvern notanda í appinu þínu
• 429 og 529 meðhöndluð með bið; beiðnaauðkenni skráð
• Vinaleg villustaða sem brýtur ekki síðuna
• Prófað með tómum, mjög löngum og fjandsamlegum inntökum

Að nota Claude API í Mythex

Í öppum sem þú smíðar á Mythex nota Claude-eiginleikar þinn eigin Anthropic-lykil og eru reiknaðir á Anthropic-reikninginn þinn, ekki á Mythex-smíðiseiningar. Það er aðskilið frá Mythex-agentinum sem skrifar kóðann þinn. Bættu ANTHROPIC_API_KEY við sem leyndarmál verkefnisins í gegnum /secrets, stillingar verkefnisins eða leyndarmálaspjaldið í spjallinu, og lýstu síðan eiginleikanum með fyrirmælum eins og þeim hér að ofan. Birtu aftur eftir að þú breytir leyndarmálum í birtu appi. Sjá Bættu AI-eiginleikum við með þínum eigin API-lyklum fyrir upphafsfyrirmæli. Ef þú ert að velja á milli þjónustuaðila fjallar hvernig þú tengir OpenAI API um sama efni fyrir OpenAI.

Spurningar