ජපානයේ Sakura Internet සපයන Sakura AI Engine නවතම free tier එකේ API භාවිතා කරන විට, මා තුන් වැරදි අදහස් කර තිබුණා. ඒවා නිසා කේතය දෙවරක් බිඳී, සැබෑ ප්රතිචාරයක් ලැබීමට පෙර ගැටලු මතුවුණා.
ප්රථමයෙන්, නොමිලේ සැලසුමකට ලියාපදිංචි වීමේදී ණයපත්ර (credit‑card) තොරතුරු ඇතුළත් කිරීමට ඉල්ලීමක් දැක්කා. බොහෝ අය එය ගාස්තු අයකිරීමේ නියමයක් කියලා හිතනවා, නමුත් මෙහිදී එය පරිශීලක හඳුනා ගැනීමේ පියවරක් පමණයි. ගාස්තු අයකිරීමේ සැලසුම වෙනම pay‑as‑you‑go වර්ගයක් වන අතර, free tier එකේ 3,000 chat completions සීමාවට පසුම පමණක් rate‑limit වෙයි.
දෙවැනි වැරදි අදහස Anthropic SDK භාවිතයයි. එකම API token එක OpenAI‑compatible endpoint එකට සහ Anthropic‑compatible endpoint එකට යොදාගත්තා. OpenAI SDK එකේ api_key පරාමිතිය x‑api‑key header එකක් යවනවා, නමුත් Sakura AI Engine හි Anthropic endpoint එක Bearer token (auth_token) බලාපොරොත්තු වෙයි. ඒ නිසා 401 Unauthorized දෝෂයක් ලැබුණා. සැලැස්ම වශයෙන් auth_token=" ලෙස සැකසීමෙන් ගැටළුව විසඳිය හැක.
තුන්වැනි වැරදි අදහස ප්රතිචාරයේ content[0] එකට සෘජුවම ප්රවේශ වීමයි. Anthropic SDK එකේ ThinkingBlock වස්තුවට text ගුණය නැත, එබැවින් resp.content[0].text ලෙස අරගන්න උත්සාහ කළාම AttributeError එකක් ලැබේ. විසඳුම වන්නේ resp.content ලැයිස්තුවෙන් type == "text" වන අයිතමයන් පමණක් තෝරා, ඒවායේ text ගුණය ලබා ගැනීමයි.
ශ්රී ලංකාවට ඇති වැදගත්කම
මෙම සිදුවීම් ශ්රී ලංකාවේ AI සංවර්ධකයින්ට විශාල පාඩම් ලබා දේ. මුලින්ම, නොමිලේ සැලසුමකට පවා credit‑card ඉල්ලීමක් ඇතිවීමේ අර්ථය නිවැරදිව තේරුම් ගැනීම වැදගත්. එය බිල්පත් පද්ධතියක් නොව, පරිශීලක සත්යාපනයක් බව දැන ගැනීමෙන් අතුරුදන් වීමක් වැළැක්විය හැක.
දෙවනුව, විවිධ SDK මගින් එකම endpoint එකට සම්බන්ධ වීමට උත්සාහ කරන විට, authentication header ආකාරය වෙනස් විය හැකි බව සැලකිල්ලට ගත යුතුය. එය වැරදි සත්යාපන කේතයක් හේතුවෙන් API ප්රවේශය අහෝසි වීමක් සිදු කරයි.
තුන්වනුව, API ප්රතිචාර සැකසීමේදී නිවැරදි data structure එක භාවිතා කිරීම අත්යවශ්යය. කේතයේ වැරදි index කිරීමෙන් runtime දෝෂ ඇතිවී, වැඩි වේලාවක් නෙට්වර්ක් කෝල් වලට වැය වීමේ අවදානමක් ඇත.
මෙම ගැටළු සරල තනි-ලයින් විසඳුම් සමඟ ඉක්මනින් නිරාකරණය කළ හැකි බැවින්, ශ්රී ලංකාවේ start‑up, තාක්ෂණික විශ්වවිද්යාල සිසුන්, හා AI‑ආශ්රිත ව්යාපාර සඳහා මේවා ඉතා ප්රයෝජනවත් පළපුරුදු පදනමක් වේ.
අවසානයේ, API සත්යාපනය හා ප්රතිචාර සැකසුම් පිළිබඳ නිවැරදි අවබෝධයක් ඇති කරගැනීමෙන්, ගෝලීය AI සේවා භාවිතා කරමින් ගුණාත්මක නිෂ්පාදන නිර්මාණය කිරීමේ මාර්ගය පහසු වේ.
