உங்கள் ஆப்பில் Claude API-ஐ எப்படி இணைப்பது

Claude API-ஐ ஒருங்கிணைக்க, Anthropic-இன் Claude Console-இல் ஒரு API விசையை உருவாக்குங்கள், அதை சர்வர் பக்க ரகசியமாக சேமியுங்கள் (பொதுவாக ANTHROPIC_API_KEY), பின்னர் உங்கள் சொந்த சர்வரில் உள்ள ஒரு route-இலிருந்து Anthropic-இன் அதிகாரப்பூர்வ SDK-களில் ஒன்றின் மூலம் Messages API-ஐ அழையுங்கள். ஒவ்வொரு கோரிக்கையும் ஒரு model-ஐக் குறிப்பிடுகிறது, max_tokens (நீங்கள் ஏற்கும் நீண்ட பதில்) அமைக்கிறது, உரையாடலை messages ஆக அனுப்புகிறது; உங்கள் அறிவுறுத்தல்கள் தனி system prompt-இல் இருக்கும். செலவு வரம்பை அமையுங்கள், நீண்ட பதில்களை streaming செய்யுங்கள், rate-limit (429) மற்றும் overload (529) பிழைகளை மீண்டும் முயற்சிகளுடன் கையாளுங்கள்.

இந்த வழிகாட்டி அமைப்பு, பாதுகாப்பான கோரிக்கை ஓட்டம், AI builder-க்கான prompt-கள், எதிர்பார்க்க வேண்டிய பிழைகள் ஆகியவற்றை உள்ளடக்கியது. Anthropic விவரங்கள் செப்டம்பர் 2026 நிலவரப்படி அதன் ஆவணங்களிலிருந்து. டோக்கன்களும் விலையும் பொதுவாக எப்படி வேலை செய்கின்றன என்பதற்கு, LLM API-களை எப்படிப் பயன்படுத்துவது என்பதை முதலில் படியுங்கள்.

இதைக் கொண்டு நீங்கள் என்ன உருவாக்கலாம்

அரட்டை உதவியாளர்கள் மற்றும் உதவி widget-கள் (AI சாட்போட் ஆப்பை எப்படி உருவாக்குவது)
சுருக்கங்கள், மறுஎழுத்துகள், வரைவு செய்யப்பட்ட பதில்கள்
ஆவணங்கள், மின்னஞ்சல்கள், படிவங்களிலிருந்து புலங்களைப் பிரித்தெடுத்தல்
உங்கள் சொந்த உள்ளடக்கத்திலிருந்து கேள்விகளுக்குப் பதிலளித்தல்
tool use மூலம் உங்கள் ஆப்பின் செயல்பாடுகளை அழைக்கும் ஏஜென்ட்கள்

மேலும் யோசனைகளுக்கு, உங்கள் ஆப்பில் AI அம்சங்களைச் சேர்ப்பது எப்படி பாருங்கள்.

Messages API ஒரு பார்வையில்

Anthropic-இன் API குறிப்பின்படி, ஒரு கோரிக்கை https://api.anthropic.com/v1/messages-க்கு ஒரு POST ஆகும்; அதில்:

பகுதி	அது என்ன
`x-api-key` தலைப்பு	உங்கள் API விசை
`anthropic-version` தலைப்பு	API பதிப்பு, எடுத்துக்காட்டாக `2023-06-01`
`model` (கட்டாயம்)	எந்த Claude மாதிரியைப் பயன்படுத்துவது
`max_tokens` (கட்டாயம்)	பதில் கொண்டிருக்கக்கூடிய அதிகபட்ச டோக்கன்கள்; மாதிரி அதற்கு முன்பே நிறுத்தலாம்
`messages` (கட்டாயம்)	உரையாடல்: மாறி மாறி வரும் `user` மற்றும் `assistant` திருப்பங்கள்
`system` (விருப்பம்)	முழு உரையாடலுக்கும் பொருந்தும் அறிவுறுத்தல்கள்
`stream` (விருப்பம்)	பதில் எழுதப்படும்போதே பெற `true` என அமையுங்கள், server-sent events வழியாக

API நிலையற்றது: உரையாடலைத் தொடர, ஒவ்வொரு கோரிக்கையுடனும் முந்தைய திருப்பங்களை மீண்டும் அனுப்ப வேண்டும். அதனால்தான் நீண்ட அரட்டைகள் ஒவ்வொரு செய்திக்கும் அதிகம் செலவாகும்.

Anthropic Python, TypeScript, C#, Go, Java, PHP மற்றும் Ruby-க்கான அதிகாரப்பூர்வ SDK-களை வெளியிடுகிறது. அவை தலைப்புகளை அமைக்கின்றன, பதில்களைப் பகுக்கின்றன, streaming-ஐ ஆதரிக்கின்றன. காரணம் இல்லாவிட்டால் நேரடி HTTP-க்குப் பதிலாக ஒன்றைப் பயன்படுத்துங்கள்.

மாதிரியைத் தேர்ந்தெடுப்பது

Anthropic பல Claude மாதிரிகளை வழங்குகிறது; அவை திறன், வேகம், விலைக்கு இடையே வேறுபடுகின்றன, மற்றும் அவற்றின் வரிசை மாறும். உங்கள் பணியை நன்றாகச் செய்யும் சிறிய மாதிரியைத் தேர்ந்தெடுத்து, உண்மையான உதாரணங்களில் சோதியுங்கள், மாதிரி ID-யை உள்ளமைவில் வையுங்கள், அதனால் குறியீட்டை மாற்றாமல் மாற்றலாம். தற்போதைய விருப்பங்களுக்கும் கட்டணங்களுக்கும் Anthropic-இன் மாதிரிகள் மற்றும் விலை பக்கங்களைப் பாருங்கள்.

உங்கள் கணக்கை அமைத்தல்

platform.claude.com-இல் Claude Console-இல் உள்நுழைந்து பில்லிங்கைச் சேருங்கள்.
ஒரு API விசையை உருவாக்குங்கள். சோதனைக்கும் உற்பத்திக்கும் ஒரு விசை வீதம் வையுங்கள், ஒன்றை ரத்து செய்தாலும் மற்றொன்று உடையாமல் இருக்க.
செலவு வரம்பை அமையுங்கள். நீங்கள் அமைத்த செலவு வரம்பை பயன்பாடு அடையும்போது API 400 பிழையைத் தருகிறது என்று Anthropic-இன் பிழைப் பக்கம் குறிப்பிடுகிறது; அப்போது உங்கள் ஆப் தெளிவான செய்தியைக் காட்ட வேண்டும்.
Console-இல் உங்கள் கணக்கின் rate limit-களை மதிப்பாயுங்கள்; அவை ஒரு நிறுவனத்துக்கு அளவிடப்படுகின்றன.

கோரிக்கை ஓட்டம்

பயனர் உங்கள் ஆப்பில் செயல்படுகிறார்: ஒரு செய்தியை அனுப்புகிறார், "சுருக்கு" என்பதை அழுத்துகிறார்.
உலாவி Anthropic-ஐ நேரடியாக அல்ல, உங்கள் சர்வர் route-ஐ அழைக்கிறது.
உங்கள் சர்வர், பயனர் உள்நுழைந்துள்ளாரா, இந்த அம்சத்தைப் பயன்படுத்த அனுமதி உள்ளதா என்று சரிபார்த்து, ஒரு பயனருக்கான வரம்பைப் பயன்படுத்துகிறது.
அது கோரிக்கையை உருவாக்குகிறது: உங்கள் விதிகளுடன் ஒரு system prompt, பயனரின் உள்ளீடு, பணிக்குத் தேவையான தரவுத்தள தரவு.
சூழலிலிருந்து விசையுடனும் நியாயமான max_tokens-உடனும் Messages API-ஐ அழைக்கிறது.
பதிலை உலாவிக்கு streaming செய்கிறது, பதிலிலிருந்து டோக்கன் பயன்பாட்டைப் பதிவு செய்கிறது.

விருப்பங்களும் சமரசங்களும்

முடிவு	எளிய தேர்வு	எப்போது மேலும் செல்ல வேண்டும்
Streaming	முழு பதிலுக்காகக் காத்திருங்கள்	அரட்டைக்கும் நீண்ட எதற்கும் streaming; Anthropic நீண்ட கோரிக்கைகளுக்கு streaming அல்லது batches-ஐ பரிந்துரைக்கிறது
வெளியீட்டு வடிவம்	எளிய உரை	உங்கள் குறியீடு புலங்களைப் படிக்க வேண்டியபோது structured JSON வெளியீடு
உங்கள் தரவு	தொடர்புடைய பதிவைச் சேர்க்கவும்	அதிகம் இருக்கும்போது உங்கள் உள்ளடக்கத்தில் தேடல் (RAG என்றால் என்ன)
செயல்கள்	மாதிரி உரை மட்டும் எழுதுகிறது	tool use: நீங்கள் வரையறுக்கும் ஒரு செயல்பாட்டை இயக்கும்படி மாதிரி உங்கள் குறியீட்டைக் கேட்கிறது
அவசரமற்ற மொத்த வேலை	உருப்படிகளின் மேல் loop	Message Batches API: சமர்ப்பித்து முடிவுகளுக்காக poll செய்வது

உங்கள் AI builder-க்கான prompt-கள்

முதல் அம்சம்:

"ஆவணத்தைப் பற்றி கேளுங்கள்" பலகத்தைச் சேர்க்கவும். அது POST /api/ask என்ற சர்வர் route-ஐ அழைக்கிறது; அந்த route பயனர் உள்நுழைந்துள்ளாரா, ஆவணம் அவருடையதா என்று சரிபார்க்கிறது, பிறகு அதிகாரப்பூர்வ Anthropic SDK-உடனும் ANTHROPIC_API_KEY ரகசியத்துடனும் Claude Messages API-ஐ அழைக்கிறது. மாதிரி ID-ஐ CLAUDE_MODEL ரகசியத்திலிருந்து படியுங்கள். System prompt: "ஆவணத்தில் கொடுக்கப்பட்டதிலிருந்து மட்டும் பதிலளியுங்கள். பதில் அதில் இல்லையென்றால், அதைச் சொல்லுங்கள்." ஆவண உரையையும் கேள்வியையும் அனுப்புங்கள், max_tokens-ஐ 800-ஆக அமையுங்கள், பதிலைப் பக்கத்துக்கு streaming செய்யுங்கள், விசையை ஒருபோதும் உலாவிக்கு அனுப்பாதீர்கள்.

பாதுகாப்பு விதிகளும் பிழைகளும்:

ஒவ்வொரு பயனருக்கும் ஒரு மணி நேரத்துக்கு 20 கேள்விகள் என்று வரம்பிடுங்கள், தரவுத்தளத்தில் கண்காணியுங்கள். ஒவ்வொரு பதிலிலிருந்தும் உள்ளீடு மற்றும் வெளியீட்டு டோக்கன்களை பயனர் ID மற்றும் request ID உடன் பதிவு செய்யுங்கள். 429 அல்லது 529 பிழைகளுக்கு, retry-after தலைப்பை மதித்து, exponential backoff-உடன் 3 முறை வரை மீண்டும் முயலுங்கள், பிறகு "உதவியாளர் பிஸியாக உள்ளார், சிறிது நேரத்தில் மீண்டும் முயலுங்கள்." என்று காட்டுங்கள். API செலவு வரம்புப் பிழை என்று சொன்னால், "AI அம்சங்கள் இடைநிறுத்தப்பட்டுள்ளன" என்று காட்டி நிர்வாகிக்கு எச்சரிக்கை அனுப்புங்கள்.

எதிர்பார்க்க வேண்டிய பிழைகள்

Anthropic-இன் பிழை ஆவணங்களிலிருந்து, உங்கள் ஆப் உண்மையில் சந்திக்கும் பிழைகள்:

குறியீடு	வகை	என்ன செய்ய வேண்டும்
400	`invalid_request_error`	கோரிக்கையைச் சரிசெய்யுங்கள்; நீங்கள் அமைத்த செலவு வரம்பை அடைந்தாலும் இதுவே வரும்
401	`authentication_error`	விசை இருக்கிறது, சரியானது, ரத்து செய்யப்படவில்லை என்று சரிபாருங்கள்
413	`request_too_large`	குறைவாக அனுப்புங்கள்; Messages API ஒரு கோரிக்கைக்கு 32 MB வரை ஏற்கிறது
429	`rate_limit_error`	`retry-after`-ஐ மதித்து பின்வாங்கி மீண்டும் முயலுங்கள்
500	`api_error`	backoff உடன் மீண்டும் முயலுங்கள்; தொடர்ந்தால் request ID உடன் ஆதரவை அணுகுங்கள்
529	`overloaded_error`	எல்லாப் பயனர்களிடமும் தற்காலிக அதிக போக்குவரத்து; பின்வாங்கி மீண்டும் முயலுங்கள்

அதிகாரப்பூர்வ SDK-கள் தற்காலிகத் தோல்விகளை (இணைப்புப் பிழைகள், rate limit-கள், 5xx பிழைகள்) இயல்பாக இரண்டு முறை exponential backoff உடன் தானாக மீண்டும் முயல்கின்றன என்று Anthropic-இன் ஆவணங்கள் கூறுகின்றன; அதை உள்ளமைக்கலாம். ஒவ்வொரு பதிலும் request-id தலைப்புடன் வருகிறது; பிரச்சினைகளைக் கண்டறிய ஆதரவுக்கு அதைப் பதிவு செய்யுங்கள்.

பொதுவான தவறுகள்

உலாவியிலிருந்து API-ஐ அழைப்பது. உங்கள் விசை பொதுவில் தெரிந்துவிடும். எப்போதும் உங்கள் சர்வர் வழியாகவே செல்லுங்கள். API விசைகளை எப்படி பாதுகாப்பாக வைத்திருப்பது பாருங்கள்.
max_tokens ஒரு இலக்கு அல்ல, ஒரு வரம்பு என்பதை மறப்பது. அம்சத்துக்குத் தேவையானதை அமையுங்கள்; மிகக் குறைவு பதில்களைத் துண்டிக்கும், மிக அதிகம் நீண்ட, விலை உயர்ந்த பதில்களை ஏற்படுத்தும்.
பயனர் செய்தியில் விதிகளை வைப்பது. நிலையான அறிவுறுத்தல்கள் system prompt-இல் இருக்க வேண்டும்; அனுமதிகள் உங்கள் குறியீட்டில் இருக்க வேண்டும்.
முழு அரட்டையையும் எப்போதும் அனுப்புவது. உரையாடல்கள் வளரும்போது பழைய திருப்பங்களைக் குறைக்கவும் சுருக்கவும் செய்யுங்கள்.
செலவு வரம்பு அல்லது பயனர் வரம்பு இல்லாதது.
மாதிரி ID-ஐ குறியீட்டில் நேரடியாக எழுதுவது. மாதிரிகள் புதுப்பிக்கப்படுகின்றன, நிறுத்தப்படுகின்றன.
நிறுத்தக் காரணத்தைப் புறக்கணிப்பது. பதில் max_tokens-ஐ அடைந்ததால் நின்றிருந்தால், பயனருக்குச் சொல்லுங்கள் அல்லது வரம்பை உயர்த்துங்கள்.

சரிபார்ப்புப் பட்டியல்

Claude Console-இல் API விசை உருவாக்கப்பட்டு சர்வர் பக்க ரகசியமாக சேமிக்கப்பட்டது
சோதனைக்கும் உற்பத்திக்கும் தனித்தனி விசைகள்
செலவு வரம்பு அமைக்கப்பட்டது; அது அடையும்போது தெளிவான செய்தி
எல்லாக் கோரிக்கைகளும் அனுமதிச் சோதனையுடன் உங்கள் சர்வர் வழியாக
விதிகள் system prompt-இல்; மாதிரி ID உள்ளமைக்கக்கூடியது
அம்சத்துக்கு max_tokens அமைக்கப்பட்டது; நீண்ட பதில்கள் streaming
உங்கள் ஆப்பில் ஒரு பயனருக்கான rate limit
429 மற்றும் 529 backoff உடன் கையாளப்படுகின்றன; request ID-கள் பதிவு
பக்கத்தை உடைக்காத நட்பான பிழை நிலை
வெற்று, மிக நீண்ட, தீங்கான உள்ளீடுகளுடன் சோதிக்கப்பட்டது

Mythex-இல் Claude API-ஐப் பயன்படுத்துதல்

Mythex-இல் நீங்கள் உருவாக்கும் ஆப்புகளில், Claude அம்சங்கள் உங்கள் சொந்த Anthropic விசையைப் பயன்படுத்துகின்றன; கட்டணம் Mythex உருவாக்க கிரெடிட்களுக்கு அல்ல, உங்கள் Anthropic கணக்குக்கு செல்லும். அது குறியீட்டை எழுதும் Mythex ஏஜெண்டிலிருந்து தனி. /secrets, திட்ட அமைப்புகள் அல்லது அரட்டையிலுள்ள ரகசியங்கள் அட்டை வழியாக ANTHROPIC_API_KEY-ஐ திட்ட ரகசியமாகச் சேர்த்து, மேலே உள்ளவை போன்ற prompt-களைப் பயன்படுத்தி அம்சத்தை விவரியுங்கள். நேரலை ஆப்பில் ரகசியங்களை மாற்றிய பின் மீண்டும் வெளியிடுங்கள். தொடக்கப் prompt-க்கு உங்கள் சொந்த API விசைகளுடன் AI அம்சங்களைச் சேர்ப்பது என்பதைப் பாருங்கள். நீங்கள் வழங்குநர்களுக்கு இடையே தேர்ந்தெடுத்தால், OpenAI API-ஐ எப்படி ஒருங்கிணைப்பது அதே விஷயங்களை OpenAI-க்கு உள்ளடக்குகிறது.

கேள்விகள்

Claude API விசையை எப்படிப் பெறுவது?

platform.claude.com இல் Claude Console-இல் உள்நுழைந்து, பில்லிங்கை அமைத்து, ஒரு API விசையை உருவாக்குங்கள். அதை ஒரு சர்வர் பக்க ரகசியமாக சேமியுங்கள், பொதுவாக ANTHROPIC_API_KEY என்ற பெயரில், உலாவிக் குறியீட்டில் ஒருபோதும் வைக்காதீர்கள்.

Claude API-க்கு ஒரு கோரிக்கை எதைக் கொண்டிருக்க வேண்டும்?

செப்டம்பர் 2026 நிலவரப்படி, Anthropic-இன் Messages API குறிப்பு மூன்று கட்டாய உடல் புலங்களைப் பட்டியலிடுகிறது: model, max_tokens மற்றும் messages. நேரடி HTTP அழைப்புகளுக்கு x-api-key மற்றும் anthropic-version தலைப்புகளும் தேவை; அதிகாரப்பூர்வ SDK-கள் அவற்றை உங்களுக்காக அமைக்கும்.

Claude API-இலிருந்து 529 பிழை என்றால் என்ன?

Anthropic-இன் பிழைப் பக்கம் 529-ஐ overloaded_error என்று விவரிக்கிறது: எல்லாப் பயனர்களிடமும் அதிக போக்குவரத்தால் API தற்காலிகமாக அதிக சுமையில் உள்ளது. exponential backoff உடன் மீண்டும் முயலுங்கள். அதிகாரப்பூர்வ SDK-கள் சில தற்காலிகப் பிழைகளை தானாக மீண்டும் முயல்கின்றன.

OpenAI SDK-க்காக எழுதப்பட்ட குறியீட்டுடன் Claude-ஐப் பயன்படுத்தலாமா?

OpenAI SDK மேற்பரப்பின் வழியாக Claude-ஐப் பயன்படுத்த, Anthropic ஒரு OpenAI SDK இணக்க அடுக்கை ஆவணப்படுத்துகிறது. புதிய குறியீட்டுக்கு, Claude-க்கே உரிய அம்சங்களுக்கு அதன் சொந்த SDK-கள் அணுகல் தருகின்றன, எனவே அவையே பொதுவாக சிறந்த தொடக்கம்.