உங்கள் ஆப்பில் OpenAI API-ஐ எப்படி இணைப்பது
OpenAI API-ஐ ஒருங்கிணைக்க, OpenAI திட்டத்தில் ஒரு API விசையை உருவாக்குங்கள், அதை OPENAI_API_KEY என்ற பெயரில் சர்வர் பக்க ரகசியமாக சேமியுங்கள், பின்னர் உலாவிக் குறியீட்டிலிருந்து ஒருபோதும் அல்ல, உங்கள் சொந்த சர்வரில் உள்ள route-இலிருந்து OpenAI-இன் அதிகாரப்பூர்வ SDK மூலம் அழையுங்கள். செப்டம்பர் 2026 நிலவரப்படி, OpenAI-இன் quickstart புதிய திட்டங்களுக்கான தொடக்கமாக Responses API-ஐ முன்வைக்கிறது. வெளியிடுவதற்கு முன் செலவு வரம்பை அமையுங்கள், பதிலின் நீளத்தை வரம்பிடுங்கள், ஒவ்வொரு பயனரும் அம்சத்தை எத்தனை முறை அழைக்கலாம் என்று கட்டுப்படுத்துங்கள், rate-limit பிழைகளை மீண்டும் முயற்சிகளுடன் கையாளுங்கள்.
இந்த வழிகாட்டி அமைப்பு, கோரிக்கை ஓட்டம், AI builder-க்கான prompt-கள், விசைகளைக் கசியவிடும் மற்றும் பணத்தை வீணடிக்கும் தவறுகள் ஆகியவற்றை உள்ளடக்குகிறது. OpenAI விவரங்கள் செப்டம்பர் 2026 நிலவரப்படி அதன் அதிகாரப்பூர்வ ஆவணங்களிலிருந்து. பொதுக் கருத்துகளுக்கு (டோக்கன்கள், context windows, விலை), முதலில் LLM API-களை எப்படிப் பயன்படுத்துவது படியுங்கள்.
இதைக் கொண்டு நீங்கள் என்ன உருவாக்கலாம்
- உங்கள் ஆப்புக்குள் ஒரு அரட்டை உதவியாளர் (AI சாட்போட் ஆப்பை எப்படி உருவாக்குவது)
- "சுருக்கு", "மறுஎழுது" அல்லது "பதில் வரை" பொத்தான்கள்
- இலவச உரையிலிருந்து கட்டமைக்கப்பட்ட தரவைப் பிரித்தெடுத்தல்: மின்னஞ்சலை ஆர்டராக மாற்றுவது, support டிக்கெட்டுகளுக்கு குறியிடுவது
- உங்கள் சொந்த உள்ளடக்கத்தில் தேடல் மற்றும் கேள்வி-பதில்
- பட உருவாக்கம், பேச்சு மற்றும் பிற ஊடக அம்சங்கள், கிடைக்கும் மாதிரிகளைப் பொறுத்து
மேலும் யோசனைகள் உங்கள் ஆப்புக்கு AI அம்சங்களைச் சேர்ப்பது எப்படி என்பதில் உள்ளன.
உங்கள் OpenAI கணக்கை அமைத்தல்
- OpenAI தளத்தில் ஒரு கணக்கு மற்றும் ஒரு திட்டத்தை உருவாக்குங்கள். OpenAI-இன் உற்பத்தி சிறந்த நடைமுறைகள் சோதனைக்கும் உற்பத்திக்கும் தனித்தனி திட்டங்களை பரிந்துரைக்கின்றன; அப்போது ஒவ்வொன்றுக்கும் தனி விசைகளும் வரம்புகளும் இருக்கும்.
- ஒரு திட்ட API விசையை உருவாக்குங்கள். காலாவதி தேதி அமைத்து, அவ்வப்போது விசைகளை மாற்றுமாறு OpenAI பரிந்துரைக்கிறது.
- limits பக்கத்தில் செலவு எச்சரிக்கைகள் மற்றும் கடுமையான செலவு வரம்பை அமையுங்கள். பயன்பாடு ஒரு தொகையைத் தாண்டும்போது எச்சரிக்கைகள் வரும், கடுமையான வரம்பு மாதாந்திர உச்சத்தை அமல்படுத்தும் என்று OpenAI-இன் வழிகாட்டி சொல்கிறது.
- பில்லிங்கைச் சேருங்கள். OpenAI-இன் rate-limit ஆவணங்கள் பயன்பாட்டு அடுக்குகளை விவரிக்கின்றன: நீங்கள் காலப்போக்கில் அதிகம் செலவிடும்போது உங்கள் வரம்புகள் தானாக உயரும்.
கோரிக்கை ஓட்டம்
உலாவி -> உங்கள் சர்வர் route -> OpenAI API
<- (streamed) பதில் <-
- பயனர் ஒரு பொத்தானை அழுத்துகிறார் அல்லது ஒரு செய்தியை அனுப்புகிறார்.
- உலாவி உங்கள் route-ஐ அழைக்கிறது, உதாரணமாக
POST /api/summarise. - உங்கள் சர்வர், பயனர் உள்நுழைந்துள்ளாரா, இந்த அம்சத்தைப் பயன்படுத்த அனுமதி உள்ளதா என்று சரிபார்க்கிறது.
- சர்வர் கோரிக்கையை உருவாக்குகிறது: அறிவுறுத்தல்கள், பயனரின் உள்ளீடு, பணிக்குத் தேவையான தரவுத்தள தரவு.
- அது சூழலிலிருந்து விசையுடன் OpenAI-ஐ அழைக்கிறது. OpenAI-இன் SDK-கள்
OPENAI_API_KEY-ஐ தானாகப் படிக்கும். - பதிலை streaming செய்கிறது அல்லது திருப்பித் தருகிறது, டோக்கன் பயன்பாட்டைப் பதிவு செய்கிறது.
OpenAI-இன் அதிகாரப்பூர்வ SDK தொகுப்பு JavaScript/TypeScript (npm) மற்றும் Python (pip) இரண்டுக்கும் openai என்று அழைக்கப்படுகிறது.
மாதிரியைத் தேர்ந்தெடுப்பது
OpenAI வெவ்வேறு விலைகளிலும் வேகங்களிலும் பல மாதிரிகளை வழங்குகிறது; வரிசை அடிக்கடி மாறுகிறது. சிறிய, மலிவான மாதிரியுடன் தொடங்குங்கள், உண்மையான உதாரணங்களில் தரத்தை அளவிடுங்கள், தேவைப்பட்டால் மட்டுமே உயருங்கள். மாதிரியின் பெயரை ஒரு உள்ளமைவு மதிப்பாகவோ ரகசியமாகவோ வையுங்கள், அதனால் குறியீட்டை மீண்டும் எழுதாமல் மாற்றலாம். தற்போதைய கட்டணங்களுக்கு OpenAI-இன் விலை பக்கத்தைப் பாருங்கள்.
விருப்பங்களும் சமரசங்களும்
| முடிவு | எளிய தேர்வு | எப்போது மேலும் செல்ல வேண்டும் |
|---|---|---|
| Streaming | முழு பதிலைத் திருப்பித் தருவது | அரட்டைக்கும் நீண்ட பதில்களுக்கும் streaming; பயனர்கள் உடனே உரையைப் பார்க்கிறார்கள் |
| உரையாடல் நினைவகம் | சமீபச் செய்திகளை ஒவ்வொரு முறையும் அனுப்புவது | அரட்டைகள் நீளும்போது பழைய செய்திகளைச் சுருக்குவது |
| வெளியீட்டு வடிவம் | எளிய உரை | உங்கள் குறியீடு புலங்களைப் படிக்க வேண்டியபோது கட்டமைக்கப்பட்ட JSON கேட்பது |
| உங்கள் சொந்தத் தரவு | தொடர்புடைய பதிவை கோரிக்கையில் சேர்ப்பது | அதிகம் இருக்கும்போது உங்கள் உள்ளடக்கத்தில் தேடலைச் சேர்ப்பது (RAG என்றால் என்ன பாருங்கள்) |
| அவசரமற்ற மொத்த வேலை | உருப்படிகளின் மேல் loop | முடிவுகள் காத்திருக்கக்கூடியபோது குறைந்த செலவுக்கு OpenAI-இன் batch விருப்பம் |
உங்கள் AI builder-க்கான prompt-கள்
முதல் அம்சம்:
டிக்கெட் பக்கத்தில் ஒரு "சுருக்கு" பொத்தானைச் சேர்க்கவும். அது POST /api/summarise என்ற சர்வர் route-ஐ அழைக்கிறது; அந்த route பயனர் உள்நுழைந்துள்ளாரா என்று சரிபார்த்து, டிக்கெட்டை ஏற்றி, அதிகாரப்பூர்வ openai SDK மற்றும் OPENAI_API_KEY ரகசியத்துடன் OpenAI Responses API-ஐ அழைக்கிறது. மாதிரியின் பெயரை OPENAI_MODEL ரகசியத்திலிருந்து படியுங்கள். அறிவுறுத்தல்: "3 புள்ளிகளில் சுருக்கு, பிறகு ஒரு சிறிய பதில் பரிந்துரை. ஆர்டர் எண்களை கண்டுபிடிக்காதே." வெளியீட்டின் நீளத்தை வரம்பிடுங்கள், பதிலைப் பக்கத்துக்கு streaming செய்யுங்கள், விசையை உலாவிக்கு ஒருபோதும் அனுப்பாதீர்கள்.
பாதுகாப்பு விதிகள்:
ஒவ்வொரு பயனருக்கும் ஒரு மணி நேரத்துக்கு 30 AI கோரிக்கைகள் என்று வரம்பிடுங்கள், தரவுத்தளத்தில் சேமியுங்கள். ஒவ்வொரு கோரிக்கைக்கும் பயனர் ID மற்றும் அம்ச பெயருடன் உள்ளீடு மற்றும் வெளியீட்டு டோக்கன்களைப் பதிவு செய்யுங்கள். OpenAI 429 தந்தால், Retry-After தலைப்பை மதித்து, exponential backoff மற்றும் jitter உடன் 3 முறை வரை மீண்டும் முயலுங்கள்; அதன் பிறகு "AI பிஸியாக உள்ளது, ஒரு நிமிடத்தில் மீண்டும் முயலுங்கள்." என்று காட்டுங்கள். மற்ற தோல்விகளுக்கு நட்பான பிழையைக் காட்டி, பக்கத்தின் மற்ற பகுதிகளை வேலை செய்ய வையுங்கள்.
பிழைகளையும் வரம்புகளையும் கையாளுதல்
OpenAI கோரிக்கைகள்-ஒரு-நிமிடம் மற்றும் டோக்கன்கள்-ஒரு-நிமிடம் உள்ளிட்ட பல வழிகளில் rate limit-களை அளவிடுகிறது; எது முதலில் தீர்ந்தாலும் அதை அடைவீர்கள். ஒன்றைத் தாண்டும்போது API Retry-After தலைப்புடன் 429-ஐத் தருகிறது. அந்த மதிப்பைக் குறைந்தபட்சமாக எடுத்து, ஒரு சிறிய சீரற்ற தாமதம் சேர்க்குமாறு OpenAI-இன் ஆவணங்கள் சொல்கின்றன; அப்போதுதான் கிளையன்ட்கள் ஒரே நேரத்தில் மீண்டும் முயலாது.
மேலும் திட்டமிட வேண்டியவை:
- நீண்ட உருவாக்கங்களுக்கான நேரவரம்புகள். Streaming உதவும்; நியாயமான வெளியீட்டு வரம்பும் உதவும்.
- வழங்குநர் செயலிழப்புகள். AI அம்சம் பக்கத்தை உடைக்காமல் சீராகத் தோல்வியடைய வேண்டும்.
- மோசமான வெளியீடு. கட்டமைக்கப்பட்ட வெளியீட்டைச் சேமிப்பதற்கு முன் சரிபாருங்கள்; உங்கள் குறியீட்டில் சோதனை இல்லாமல் மாதிரியின் வெளியீடு உணர்திறன் செயல்களைத் தூண்ட விடாதீர்கள்.
பொதுவான தவறுகள்
- முன்பக்கத்திலோ களஞ்சியத்திலோ விசை. உலாவிக் குறியீடு பொதுவானது; கசிந்த விசை சில நிமிடங்களில் துஷ்பிரயோகம் செய்யப்படலாம். API விசைகளை எப்படி பாதுகாப்பாக வைத்திருப்பது பாருங்கள்.
- செலவு வரம்பு இல்லாதது. ஒரு loop அல்லது துஷ்பிரயோகம் செய்யும் பயனர் விரைவில் பெரிய பில்லை உருவாக்கலாம்.
- ஒவ்வொரு பயனருக்கும் வரம்பு இல்லாதது. வழங்குநரின் வரம்பு உங்கள் பணப்பையைப் பாதுகாக்கும், மற்ற பயனர்களை அல்ல.
- பாதுகாப்புக்காக prompt-ஐ நம்புவது. "முந்தைய அறிவுறுத்தல்களைப் புறக்கணி" என்று பயனர்கள் தட்டச்சு செய்யலாம். அனுமதிகள் சர்வர் குறியீட்டில் இருக்க வேண்டும்.
- தேவைக்கு மேல் அனுப்புவது. முழு ஆவணங்களும் நீண்ட வரலாறுகளும் செலவைப் பெருக்கும். பணிக்குத் தேவையானதை மட்டும் அனுப்புங்கள்.
- மாதிரியின் பெயரை குறியீட்டில் எழுதுவது. மாதிரிகள் புதுப்பிக்கப்படுகின்றன, நிறுத்தப்படுகின்றன; அதை ஓர் அமைப்பாக வையுங்கள்.
- தனிப்பட்ட தரவை யோசிக்காமல் அனுப்புவது. OpenAI-இன் தரவுப் பயன்பாட்டு விதிகளைப் படித்து, அம்சத்துக்குத் தேவையானதை மட்டும் அனுப்புங்கள்.
சரிபார்ப்புப் பட்டியல்
- சோதனைக்கும் உற்பத்திக்கும் தனி OpenAI திட்டங்கள் (அல்லது விசைகள்)
- விசை சர்வர் பக்க ரகசியமாக சேமிக்கப்பட்டது; உலாவிக் குறியீட்டிலோ களஞ்சியத்திலோ இல்லை
- செலவு எச்சரிக்கைகளும் கடுமையான செலவு வரம்பும் அமைக்கப்பட்டன
- எல்லா அழைப்புகளும் உங்கள் சர்வர் வழியாகச் சென்று பயனர் அனுமதிகளைச் சரிபார்க்கின்றன
- வெளியீட்டின் நீளம் வரம்பிடப்பட்டது; மாதிரியின் பெயர் உள்ளமைக்கக்கூடியது
- உங்கள் ஆப்பில் ஒரு பயனருக்கான rate limit
- Retry-After, backoff, jitter உடன் 429 கையாளுதல்
- நட்பான பிழை நிலை; AI இல்லாமலும் பக்கம் வேலை செய்கிறது
- அம்சம் வாரியாக டோக்கன் பயன்பாடு பதிவு செய்யப்படுகிறது
- நீண்ட, வெற்று, தீங்கான உள்ளீடுகளுடன் சோதிக்கப்பட்டது
Mythex-இல் OpenAI API-ஐப் பயன்படுத்துதல்
Mythex-இல் நீங்கள் உருவாக்கும் ஆப்புகளில் AI அம்சங்கள் உங்கள் சொந்த OpenAI விசையைப் பயன்படுத்துகின்றன; கட்டணம் Mythex உருவாக்க கிரெடிட்களுக்கு அல்ல, உங்கள் OpenAI கணக்குக்கு செல்லும். /secrets, திட்ட அமைப்புகள், அல்லது விசை தேவைப்படும்போது ஏஜென்ட் காட்டும் ரகசியங்கள் அட்டை வழியாக OPENAI_API_KEY-ஐ திட்ட ரகசியமாகச் சேர்த்து, மேலே உள்ளவை போன்ற prompt-உடன் அம்சத்தை விவரியுங்கள். வெளியிட்ட ஆப்பில் ரகசியங்களை மாற்றிய பின், ஆப் அவற்றைப் பெற மீண்டும் வெளியிடுங்கள். உங்கள் சொந்த API விசைகளுடன் AI அம்சங்களைச் சேர்ப்பது என்ற ஆவணச் செய்முறையில் தொடக்கப் prompt உள்ளது; அரட்டையில் ரகசியங்கள் ரகசியங்கள் அட்டையை விளக்குகிறது. வழங்குநர்களை ஒப்பிடுகிறீர்களா? Claude API-ஐ எப்படி ஒருங்கிணைப்பது பாருங்கள்.
கேள்விகள்
புதிய ஆப்புக்கு எந்த OpenAI API-ஐப் பயன்படுத்த வேண்டும்?
செப்டம்பர் 2026 நிலவரப்படி, OpenAI-இன் quickstart புதிய திட்டங்களுக்கான தொடக்கப் புள்ளியாக Responses API-ஐ முன்வைக்கிறது; அதன் அதிகாரப்பூர்வ SDK-களில் client.responses.create() பயன்படுத்தப்படுகிறது. தொடங்கும் முன் தற்போதைய பரிந்துரைக்கு OpenAI-இன் ஆவணங்களைச் சரிபாருங்கள்.
உலாவியிலிருந்து OpenAI API-ஐ அழைக்கலாமா?
உங்கள் ரகசிய விசையுடன் அல்ல. உலாவிக் குறியீட்டை யாரும் படிக்கலாம், விசையை மீண்டும் பயன்படுத்தி உங்கள் பில்லை உயர்த்தலாம். உலாவி உங்கள் சொந்த சர்வர் route-ஐ அழைக்க வேண்டும்; உங்கள் சர்வர் சுற்றுச்சூழல் மாறியாக சேமிக்கப்பட்ட விசையுடன் OpenAI-ஐ அழைக்கும்.
OpenAI API செலவு அதிகமாகாமல் எப்படித் தடுப்பது?
OpenAI-இன் உற்பத்தி வழிகாட்டி, limits பக்கத்தில் செலவு எச்சரிக்கைகள் மற்றும் கடுமையான மாதாந்திர செலவு வரம்பை பரிந்துரைக்கிறது. உங்கள் ஆப்பில் பதிலின் நீளத்தை வரம்பிடுங்கள், ஒவ்வொரு பயனருக்கும் கோரிக்கைகளை வரம்பிடுங்கள், டோக்கன் பயன்பாட்டைப் பதிவு செய்யுங்கள், அதனால் எந்த அம்சம் அதிகம் செலவாகிறது என்று பார்க்கலாம்.
OpenAI-இலிருந்து 429 பிழை என்றால் என்ன?
நீங்கள் ஒரு rate limit-ஐ அடைந்துவிட்டீர்கள் என்று பொருள். OpenAI-இன் rate-limit ஆவணங்கள், பதிலில் Retry-After தலைப்பு இருக்கும் என்கின்றன; அந்த நேரமாவது காத்திருந்து, ஒரு சிறிய சீரற்ற தாமதம் சேர்த்து, exponential backoff உடன் மீண்டும் முயலுங்கள்.