તમારી એપમાં Claude API કેવી રીતે ઇન્ટિગ્રેટ કરવું
Claude API ઇન્ટિગ્રેટ કરવા માટે, Anthropic ના Claude Console માં API key બનાવો, તેને સર્વર-સાઇડ સિક્રેટ તરીકે સાચવો (સામાન્ય રીતે ANTHROPIC_API_KEY), અને Anthropic ના સત્તાવાર SDK માંથી એકનો ઉપયોગ કરીને તમારા પોતાના સર્વર પરના રૂટ પરથી Messages API કૉલ કરો. દરેક વિનંતી એક model નામ આપે છે, max_tokens સેટ કરે છે (તમે સ્વીકારશો તે સૌથી લાંબો જવાબ), અને વાતચીત messages તરીકે મોકલે છે, જ્યારે તમારી સૂચનાઓ અલગ system પ્રોમ્પ્ટમાં હોય છે. ખર્ચ મર્યાદા સેટ કરો, લાંબા જવાબોને streaming કરો, અને રેટ-લિમિટ (429) તથા ઓવરલોડ (529) એરર માટે retry સાથે હેન્ડલ કરો.
આ ગાઇડ સેટઅપ, સુરક્ષિત વિનંતી ફ્લો, AI બિલ્ડર માટેના પ્રોમ્પ્ટ, અને જે એરર માટે તૈયારી કરવી તે આવરી લે છે. Anthropic ની વિગતો સપ્ટેમ્બર 2026 સુધીના તેમના દસ્તાવેજોમાંથી છે. ટોકન અને પ્રાઇસિંગ સામાન્ય રીતે કેવી રીતે કામ કરે છે તે માટે, LLM API કેવી રીતે વાપરવી જુઓ.
તેનાથી તમે શું બનાવી શકો
- ચેટ આસિસ્ટન્ટ અને હેલ્પ વિજેટ (AI ચેટબોટ એપ કેવી રીતે બનાવવી)
- સારાંશ, ફરીથી લખાણ અને ડ્રાફ્ટ કરેલા જવાબો
- દસ્તાવેજો, ઇમેઇલ અને ફોર્મમાંથી ફીલ્ડ કાઢવા
- તમારી પોતાની સામગ્રી પરથી પ્રશ્નોના જવાબ આપવા
- ટૂલ યુઝ દ્વારા તમારી એપના ફંક્શન કૉલ કરતા એજન્ટ
વધુ વિચારો માટે, તમારી એપમાં AI ફીચર્સ કેવી રીતે ઉમેરવા જુઓ.
Messages API ટૂંકમાં
Anthropic ના API રેફરન્સ મુજબ, વિનંતી https://api.anthropic.com/v1/messages પર POST છે, જેમાં:
| ભાગ | તે શું છે |
|---|---|
x-api-key હેડર | તમારી API key |
anthropic-version હેડર | API વર્ઝન, ઉદાહરણ તરીકે 2023-06-01 |
model (જરૂરી) | કયો Claude model વાપરવો |
max_tokens (જરૂરી) | જવાબમાં મહત્તમ ટોકન; model તેના પહેલા અટકી શકે છે |
messages (જરૂરી) | વાતચીત: વારાફરતી user અને assistant ટર્ન |
system (વૈકલ્પિક) | આખી વાતચીત પર લાગુ થતી સૂચનાઓ |
stream (વૈકલ્પિક) | જવાબ લખાતાની સાથે server-sent events દ્વારા મેળવવા true સેટ કરો |
API સ્ટેટલેસ છે: વાતચીત ચાલુ રાખવા માટે, દરેક વિનંતી સાથે અગાઉના ટર્ન ફરી મોકલો. તેથી લાંબી ચેટનો દરેક મેસેજ વધુ ખર્ચ કરે છે.
Anthropic Python, TypeScript, C#, Go, Java, PHP અને Ruby માટે સત્તાવાર SDK પ્રકાશિત કરે છે. તે હેડર્સ સેટ કરે છે, જવાબો પાર્સ કરે છે, અને streaming ને સપોર્ટ કરે છે. કોઈ ખાસ કારણ ન હોય તો કાચા HTTP ને બદલે તેનો ઉપયોગ કરો.
model પસંદ કરવો
Anthropic ઘણા Claude models આપે છે, જે ક્ષમતા અને ઝડપ/કિંમત વચ્ચે સમતોલન રાખે છે, અને તેની યાદી બદલાતી રહે છે. તમારું કાર્ય સારી રીતે કરે તે સૌથી નાનું model પસંદ કરો, વાસ્તવિક ઉદાહરણો પર ટેસ્ટ કરો, અને model ID ને કન્ફિગરેશનમાં રાખો જેથી કોડ બદલ્યા વિના સ્વિચ કરી શકાય. હાલના વિકલ્પો અને દરો માટે Anthropic ના models અને pricing પેજ તપાસો.
તમારું એકાઉન્ટ સેટ કરવું
- platform.claude.com પર Claude Console માં સાઇન ઇન કરો અને બિલિંગ ઉમેરો.
- API key બનાવો. દરેક એન્વાયર્નમેન્ટ (ટેસ્ટિંગ અને પ્રોડક્શન) માટે એક key રાખો, જેથી એક રદ કરો તો બીજી તૂટે નહીં.
- ખર્ચ મર્યાદા સેટ કરો. Anthropic ના errors પેજ નોંધે છે કે જ્યારે તમે સેટ કરેલી ખર્ચ મર્યાદા પહોંચે, ત્યારે API 400 એરર આપે છે, એટલે આવું થાય ત્યારે તમારી એપે સ્પષ્ટ સંદેશ બતાવવો જોઈએ.
- Console માં તમારા એકાઉન્ટની રેટ લિમિટ તપાસો; તે દરેક organization માટે માપવામાં આવે છે.
વિનંતી ફ્લો
- યુઝર તમારી એપમાં કામ કરે છે: મેસેજ મોકલે છે, "Summarise" પર ક્લિક કરે છે.
- બ્રાઉઝર સીધું Anthropic ને નહીં, તમારા સર્વર રૂટને કૉલ કરે છે.
- તમારું સર્વર તપાસે છે કે યુઝર લૉગ ઇન છે અને ફીચર વાપરવાની મંજૂરી ધરાવે છે, અને યુઝર દીઠ મર્યાદા લાગુ કરે છે.
- તે વિનંતી બનાવે છે: તમારા નિયમો સાથેનો system પ્રોમ્પ્ટ, યુઝરનું ઇનપુટ, અને કાર્યને જરૂરી કોઈ પણ ડેટા તમારા ડેટાબેઝમાંથી.
- તે પર્યાવરણમાંથી key સાથે અને યોગ્ય
max_tokensસાથે Messages API કૉલ કરે છે. - તે જવાબને બ્રાઉઝરમાં streaming કરે છે અને જવાબમાંથી ટોકન વપરાશ લોગ કરે છે.
વિકલ્પો અને ટ્રેડ-ઓફ
| નિર્ણય | સરળ પસંદગી | ક્યારે વધુ આગળ જવું |
|---|---|---|
| Streaming | સંપૂર્ણ જવાબની રાહ જુઓ | ચેટ અને લાંબી કોઈ પણ વસ્તુ માટે streaming કરો; લાંબા સમય ચાલતી વિનંતીઓ માટે Anthropic streaming અથવા batches સૂચવે છે |
| આઉટપુટ ફોર્મેટ | સાદો ટેક્સ્ટ | જ્યારે તમારા કોડને ફીલ્ડ વાંચવાના હોય ત્યારે structured JSON આઉટપુટ |
| તમારો ડેટા | સંબંધિત રેકોર્ડ શામેલ કરો | ઘણું હોય ત્યારે તમારી સામગ્રી પર retrieval (RAG શું છે) |
| ક્રિયાઓ | મોડેલ ફક્ત ટેક્સ્ટ લખે છે | ટૂલ યુઝ, જેમાં મોડેલ તમે વ્યાખ્યાયિત કરેલું ફંક્શન ચલાવવા તમારા કોડને કહે છે |
| મોટા પાયે, તાત્કાલિક ન હોય તેવું કામ | આઇટમ્સ પર લૂપ | Message Batches API, જેમાં તમે સબમિટ કરો અને પરિણામો માટે પોલ કરો |
તમારા AI બિલ્ડરને આપવાના પ્રોમ્પ્ટ
પ્રથમ ફીચર:
"Ask about this document" પેનલ ઉમેરો. તે સર્વર રૂટ POST /api/ask ને કૉલ કરે છે, જે તપાસે છે કે યુઝર લૉગ ઇન છે અને દસ્તાવેજનો માલિક છે, પછી સત્તાવાર Anthropic SDK અને સિક્રેટ ANTHROPIC_API_KEY વડે Claude Messages API કૉલ કરે છે. model ID સિક્રેટ CLAUDE_MODEL માંથી વાંચો. System પ્રોમ્પ્ટ: "ફક્ત આપેલા દસ્તાવેજ પરથી જવાબ આપો. જો જવાબ તેમાં ન હોય, તો તે કહો." દસ્તાવેજનો ટેક્સ્ટ અને પ્રશ્ન મોકલો, max_tokens 800 સેટ કરો, જવાબ પેજ પર streaming કરો, અને key ક્યારેય બ્રાઉઝરમાં ખુલ્લી ન કરો.
ગાર્ડરેઇલ્સ અને એરર:
દરેક યુઝરને કલાકમાં 20 પ્રશ્નો સુધી મર્યાદિત કરો, જે ડેટાબેઝમાં ટ્રૅક થાય. દરેક જવાબમાંથી યુઝર ID અને રિક્વેસ્ટ ID સાથે input અને output ટોકન લોગ કરો. 429 અથવા 529 એરર પર, exponential backoff સાથે 3 વાર સુધી retry કરો, retry-after હેડરનું પાલન કરીને, પછી "The assistant is busy, try again shortly." બતાવો. જો API ખર્ચ મર્યાદાની એરર આપે, તો "AI features are paused" બતાવો અને એડમિનને ચેતવણી આપો.
જે એરર માટે તૈયારી કરવી
Anthropic ના errors દસ્તાવેજો મુજબ, જે તમારી એપ ખરેખર સામનો કરશે:
| કોડ | પ્રકાર | શું કરવું |
|---|---|---|
| 400 | invalid_request_error | વિનંતી સુધારો; જ્યારે તમે સેટ કરેલી ખર્ચ મર્યાદા પહોંચો ત્યારે પણ આવે છે |
| 401 | authentication_error | key હાજર, સાચી અને રદ ન થયેલી છે કે નહીં તપાસો |
| 413 | request_too_large | ઓછું મોકલો; Messages API પ્રતિ વિનંતી 32 MB સુધી સ્વીકારે છે |
| 429 | rate_limit_error | retry-after નું પાલન કરીને backoff અને retry કરો |
| 500 | api_error | backoff સાથે retry કરો; સમસ્યા ચાલુ રહે તો રિક્વેસ્ટ ID સાથે સપોર્ટનો સંપર્ક કરો |
| 529 | overloaded_error | બધા યુઝર્સ તરફથી અસ્થાયી ઊંચો ટ્રાફિક; backoff કરો અને retry કરો |
Anthropic ના દસ્તાવેજો કહે છે કે સત્તાવાર SDK અસ્થાયી નિષ્ફળતાઓ (કનેક્શન એરર, રેટ લિમિટ અને 5xx એરર) ડિફોલ્ટ રીતે exponential backoff સાથે બે વાર આપમેળે retry કરે છે, અને તમે તેને કન્ફિગર કરી શકો છો. દરેક જવાબમાં request-id હેડર હોય છે; સપોર્ટ સમસ્યાઓ ટ્રેસ કરી શકે તે માટે તેને લોગ કરો.
સામાન્ય ભૂલો
- બ્રાઉઝરમાંથી API કૉલ કરવો. તમારી key જાહેર થઈ જાય છે. હંમેશાં તમારા સર્વર દ્વારા જાઓ. જુઓ API keys કેવી રીતે સુરક્ષિત રાખવી.
- ભૂલી જવું કે
max_tokensએક મર્યાદા છે, લક્ષ્ય નથી. તે ફીચરને જરૂરી હોય તેટલું સેટ કરો; બહુ ઓછું હોય તો જવાબ કપાઈ જાય છે, બહુ વધારે હોય તો લાંબા, મોંઘા જવાબનું જોખમ. - યુઝર મેસેજમાં નિયમો મૂકવા. સ્થિર સૂચનાઓ
systemપ્રોમ્પ્ટમાં હોવી જોઈએ; પરવાનગીઓ તમારા કોડમાં હોવી જોઈએ. - આખી ચેટ હંમેશ માટે મોકલવી. વાતચીત વધે તેમ જૂના ટર્નને કાપો અથવા સારાંશ આપો.
- કોઈ ખર્ચ મર્યાદા કે યુઝર દીઠ મર્યાદા ન હોવી.
- model ID ને હાર્ડ-કોડ કરવો. Models અપડેટ અને નિવૃત્ત થતા રહે છે.
- stop reason ને અવગણવું. જો જવાબ
max_tokensપર પહોંચવાથી અટક્યો હોય, તો યુઝરને જણાવો અથવા મર્યાદા વધારો.
ચેકલિસ્ટ
- Claude Console માં API key બનાવી અને સર્વર-સાઇડ સિક્રેટ તરીકે સાચવી
- ટેસ્ટિંગ અને પ્રોડક્શન માટે અલગ keys
- ખર્ચ મર્યાદા સેટ; પહોંચે ત્યારે સ્પષ્ટ સંદેશ
- બધી વિનંતીઓ પરમિશન ચેક સાથે તમારા સર્વર દ્વારા
- System પ્રોમ્પ્ટમાં નિયમો; model ID કન્ફિગર કરી શકાય તેવું
- દરેક ફીચર માટે
max_tokensસેટ; લાંબા જવાબો streaming - તમારી એપમાં યુઝર દીઠ રેટ લિમિટ
- 429 અને 529 backoff સાથે હેન્ડલ; રિક્વેસ્ટ ID લોગ
- પેજ તૂટે નહીં તેવી મૈત્રીપૂર્ણ એરર સ્થિતિ
- ખાલી, ખૂબ લાંબા અને દુર્ભાવનાપૂર્ણ ઇનપુટ સાથે ટેસ્ટ
Mythex માં Claude API વાપરવી
Mythex પર તમે બનાવેલી એપમાં, Claude ફીચર્સ તમારી પોતાની Anthropic key વાપરે છે અને તમારા Anthropic એકાઉન્ટમાં બિલ થાય છે, Mythex બિલ્ડ ક્રેડિટમાં નહીં. તે કોડ લખતા Mythex એજન્ટથી અલગ છે. ANTHROPIC_API_KEY ને /secrets, પ્રોજેક્ટ સેટિંગ્સ અથવા ચેટમાંના સિક્રેટ કાર્ડ દ્વારા પ્રોજેક્ટ સિક્રેટ તરીકે ઉમેરો, પછી ઉપરના જેવા પ્રોમ્પ્ટ વાપરીને ફીચરનું વર્ણન કરો. લાઇવ એપમાં સિક્રેટ બદલ્યા પછી ફરી પબ્લિશ કરો. સ્ટાર્ટર પ્રોમ્પ્ટ માટે તમારી પોતાની API keys વડે AI ફીચર્સ ઉમેરો જુઓ. જો તમે પ્રોવાઇડર પસંદ કરી રહ્યા હો, તો OpenAI API કેવી રીતે ઇન્ટિગ્રેટ કરવી OpenAI માટે એ જ વિષય આવરી લે છે.
પ્રશ્નો
Claude API key કેવી રીતે મેળવવી?
platform.claude.com પર Claude Console માં સાઇન ઇન કરો, બિલિંગ સેટ કરો અને API key બનાવો. તેને સર્વર-સાઇડ સિક્રેટ તરીકે સાચવો, જેનું નામ સામાન્ય રીતે ANTHROPIC_API_KEY રાખવામાં આવે છે, અને તેને ક્યારેય બ્રાઉઝર કોડમાં ન મૂકો.
Claude API ને વિનંતી માટે શું જોઈએ?
સપ્ટેમ્બર 2026 મુજબ, Anthropic ના Messages API રેફરન્સમાં ત્રણ જરૂરી બોડી ફીલ્ડ્સ છે: model, max_tokens અને messages. સીધા HTTP કૉલ્સને x-api-key અને anthropic-version હેડર્સ પણ જોઈએ; સત્તાવાર SDK આ હેડર્સ તમારા માટે સેટ કરે છે.
Claude API માંથી 529 એરર શું છે?
Anthropic ના errors પેજ મુજબ 529 એ overloaded_error છે: બધા યુઝર્સ તરફથી વધુ ટ્રાફિકને કારણે API અસ્થાયી રીતે ઓવરલોડ છે. exponential backoff સાથે ફરી પ્રયાસ કરો. સત્તાવાર SDK કેટલીક અસ્થાયી એરર આપમેળે ફરી અજમાવે છે.
શું OpenAI SDK માટે લખેલા કોડમાં Claude વાપરી શકાય?
Anthropic OpenAI SDK સુસંગતતા લેયર દસ્તાવેજીકૃત કરે છે, જેનાથી OpenAI SDK ના સરફેસ દ્વારા Claude વાપરી શકાય. નવા કોડ માટે, તેના પોતાના SDK Claude-ના ખાસ ફીચર્સ આપે છે, એટલે સામાન્ય રીતે તે વધુ સારી શરૂઆત છે.