మీ యాప్లో OpenAI API ను ఎలా ఇంటిగ్రేట్ చేయాలి
OpenAI API ను ఇంటిగ్రేట్ చేయడానికి, OpenAI ప్రాజెక్ట్లో API కీ సృష్టించండి, దాన్ని OPENAI_API_KEY అనే పేరుతో సర్వర్ వైపు సీక్రెట్గా నిల్వ చేయండి, మరియు OpenAI అధికారిక SDKను ఉపయోగించి మీ స్వంత సర్వర్లోని రూట్ నుంచి కాల్ చేయండి — ఎప్పుడూ బ్రౌజర్ కోడ్ నుంచి కాదు. సెప్టెంబర్ 2026 నాటికి, OpenAI యొక్క క్విక్స్టార్ట్ కొత్త ప్రాజెక్ట్లకు ప్రారంభ బిందువుగా Responses API ను చూపిస్తుంది. లాంచ్కు ముందు స్పెండ్ లిమిట్ సెట్ చేయండి, రిప్లై పొడవును పరిమితం చేయండి, ప్రతి యూజర్ ఈ ఫీచర్ను ఎంత తరచుగా కాల్ చేయగలరో పరిమితం చేయండి, మరియు రేట్-లిమిట్ ఎర్రర్లను రీట్రైలతో నిర్వహించండి.
ఈ గైడ్ సెటప్, రిక్వెస్ట్ ఫ్లో, AI బిల్డర్ కోసం ప్రాంప్ట్లు, మరియు కీలు లీక్ చేసే లేదా డబ్బు వృథా చేసే తప్పులను కవర్ చేస్తుంది. OpenAI వివరాలు సెప్టెంబర్ 2026 నాటి దాని అధికారిక డాక్యుమెంటేషన్ నుంచి తీసుకోబడ్డాయి. సాధారణ భావనల (టోకెన్లు, కాంటెక్స్ట్ విండోలు, ధరలు) కోసం ముందుగా LLM APIs ను ఎలా ఉపయోగించాలి చదవండి.
దీనితో మీరు ఏమి నిర్మించవచ్చు
- మీ యాప్లో ఒక చాట్ అసిస్టెంట్ (AI చాట్బాట్ యాప్ను ఎలా నిర్మించాలి)
- “ఇది సారాంశం చేయి”, “ఇది తిరిగి రాయి” లేదా “రిప్లై డ్రాఫ్ట్ చేయి” బటన్లు
- ఉచిత టెక్స్ట్ నుంచి స్ట్రక్చర్డ్ డేటా సేకరించడం: ఇమెయిల్ను ఆర్డర్గా మార్చడం, సపోర్ట్ టికెట్లకు ట్యాగ్ చేయడం
- మీ స్వంత కంటెంట్పై సెర్చ్ మరియు ప్రశ్నలకు సమాధానాలు
- ఇమేజ్ జనరేషన్, స్పీచ్ మరియు ఇతర మీడియా ఫీచర్లు, అందుబాటులో ఉన్న మోడళ్లను బట్టి
మరిన్ని ఆలోచనలు మీ యాప్కు AI ఫీచర్లు ఎలా జోడించాలి లో ఉన్నాయి.
మీ OpenAI ఖాతాను సెటప్ చేయడం
- OpenAI ప్లాట్ఫామ్లో ఖాతా మరియు ప్రాజెక్ట్ సృష్టించండి. OpenAI యొక్క ప్రొడక్షన్ బెస్ట్ ప్రాక్టీసెస్ స్టేజింగ్ మరియు ప్రొడక్షన్ కోసం వేర్వేరు ప్రాజెక్ట్లను సిఫార్సు చేస్తాయి, తద్వారా ప్రతిదానికి దాని స్వంత కీలు మరియు లిమిట్లు ఉంటాయి.
- ప్రాజెక్ట్ API కీ సృష్టించండి. OpenAI గడువు తేదీ సెట్ చేయమని మరియు కీలను క్రమం తప్పకుండా రొటేట్ చేయమని సిఫార్సు చేస్తుంది.
- లిమిట్స్ పేజీలో స్పెండ్ అలర్ట్లు మరియు కఠినమైన స్పెండ్ లిమిట్ సెట్ చేయండి. OpenAI గైడ్ ప్రకారం, వినియోగం ఒక మొత్తాన్ని దాటినప్పుడు అలర్ట్లు మీకు తెలియజేస్తాయి, మరియు కఠినమైన లిమిట్ నెలవారీ పరిమితిని అమలు చేస్తుంది.
- బిల్లింగ్ జోడించండి. OpenAI రేట్-లిమిట్ డాక్స్ వినియోగ టియర్లను వివరిస్తాయి: మీరు కాలక్రమేణా ఎక్కువ ఖర్చు చేసేకొద్దీ మీ లిమిట్లు స్వయంచాలకంగా పెరుగుతాయి.
రిక్వెస్ట్ ఫ్లో
Browser -> your server route -> OpenAI API
<- (streamed) reply <-
- యూజర్ బటన్ క్లిక్ చేస్తాడు లేదా మెసేజ్ పంపుతాడు.
- బ్రౌజర్ మీ రూట్ను కాల్ చేస్తుంది, ఉదాహరణకు
POST /api/summarise. - మీ సర్వర్ యూజర్ లాగిన్ అయ్యాడో మరియు ఫీచర్ వాడటానికి అనుమతి ఉందో తనిఖీ చేస్తుంది.
- సర్వర్ రిక్వెస్ట్ను నిర్మిస్తుంది: సూచనలు, యూజర్ ఇన్పుట్, మరియు టాస్క్కు అవసరమైన ఏదైనా డేటాబేస్ డేటా.
- ఎన్విరాన్మెంట్ నుంచి కీతో OpenAI ను కాల్ చేస్తుంది. OpenAI SDKలు
OPENAI_API_KEYను స్వయంచాలకంగా చదువుతాయి. - రిప్లైను స్ట్రీమ్ చేస్తుంది లేదా తిరిగి ఇస్తుంది, మరియు టోకెన్ వినియోగాన్ని లాగ్ చేస్తుంది.
OpenAI యొక్క అధికారిక SDK ప్యాకేజీలు JavaScript/TypeScript (npm) మరియు Python (pip) రెండింటికీ openai అని పిలవబడతాయి.
మోడల్ను ఎంచుకోవడం
OpenAI వివిధ ధరలు మరియు వేగాలతో అనేక మోడళ్లను అందిస్తుంది, మరియు ఈ జాబితా తరచుగా మారుతుంది. చిన్న, చౌకైన మోడల్తో ప్రారంభించండి, నిజమైన ఉదాహరణలపై నాణ్యతను కొలవండి, మరియు అవసరమైతే మాత్రమే పైకి వెళ్లండి. మోడల్ పేరును కాన్ఫిగ్ విలువ లేదా సీక్రెట్లో ఉంచండి, తద్వారా కోడ్ తిరిగి రాయకుండానే మార్చవచ్చు. ప్రస్తుత రేట్ల కోసం OpenAI ధరల పేజీని చూడండి.
ఎంపికలు మరియు ట్రేడ్-ఆఫ్లు
| నిర్ణయం | సరళమైన ఎంపిక | ఎప్పుడు ఇంకా ముందుకు వెళ్లాలి |
|---|---|---|
| స్ట్రీమింగ్ | మొత్తం సమాధానాన్ని తిరిగి ఇవ్వండి | చాట్ మరియు పొడవైన రిప్లైలకు స్ట్రీమ్ చేయండి; యూజర్లు వెంటనే టెక్స్ట్ చూస్తారు |
| సంభాషణ మెమరీ | ప్రతిసారీ ఇటీవలి మెసేజ్లు పంపండి | చాట్లు పొడవైతే పాత మెసేజ్లను సారాంశం చేయండి |
| అవుట్పుట్ ఫార్మాట్ | సాధారణ టెక్స్ట్ | మీ కోడ్ ఫీల్డ్లను చదవాలంటే స్ట్రక్చర్డ్ JSON అడగండి |
| మీ స్వంత డేటా | సంబంధిత రికార్డ్ను రిక్వెస్ట్లో చేర్చండి | చేర్చడానికి చాలా ఎక్కువ ఉన్నప్పుడు మీ కంటెంట్పై సెర్చ్ జోడించండి (RAG అంటే ఏమిటి చూడండి) |
| అత్యవసరం కాని బల్క్ పని | ఐటమ్లపై లూప్ | ఫలితాలు వేచి ఉండగలిగితే తక్కువ ఖర్చు కోసం OpenAI బ్యాచ్ ఆప్షన్ |
మీ AI బిల్డర్కు ఇచ్చే ప్రాంప్ట్లు
మొదటి ఫీచర్:
టికెట్ పేజీలో “Summarise” బటన్ జోడించండి. ఇది సర్వర్ రూట్ POST /api/summarise ను కాల్ చేస్తుంది, ఇది యూజర్ లాగిన్ అయ్యాడో తనిఖీ చేస్తుంది, టికెట్ను లోడ్ చేస్తుంది, మరియు అధికారిక openai SDK మరియు సీక్రెట్ OPENAI_API_KEY ఉపయోగించి OpenAI Responses API ను కాల్ చేస్తుంది. మోడల్ పేరును సీక్రెట్ OPENAI_MODEL నుంచి చదవండి. సూచనలు: “3 బుల్లెట్ పాయింట్లలో సారాంశం చేయి, తర్వాత ఒక చిన్న రిప్లై సూచించు. ఆర్డర్ నంబర్లను కల్పించవద్దు.” అవుట్పుట్ పొడవును పరిమితం చేయండి, రిప్లైను పేజీకి స్ట్రీమ్ చేయండి, మరియు కీని ఎప్పుడూ బ్రౌజర్కు పంపకండి.
గార్డ్రెయిల్స్:
ప్రతి యూజర్కు గంటకు 30 AI రిక్వెస్ట్లకు పరిమితి పెట్టండి, డేటాబేస్లో నిల్వ చేయండి. ఇన్పుట్ మరియు అవుట్పుట్ టోకెన్లను యూజర్ ID మరియు ఫీచర్ పేరుతో ప్రతి రిక్వెస్ట్కు లాగ్ చేయండి. OpenAI 429 ఇస్తే, Retry-After హెడర్ను గౌరవించండి మరియు ఎక్స్పోనెన్షియల్ బ్యాక్ఆఫ్ మరియు జిటర్తో 3 సార్లు వరకు మళ్లీ ప్రయత్నించండి; ఆ తర్వాత “The AI is busy, try again in a minute.” అని చూపించండి. ఇతర ఏ వైఫల్యానికైనా స్నేహపూర్వక ఎర్రర్ చూపించి, మిగిలిన పేజీ పని చేసేలా ఉంచండి.
ఎర్రర్లు మరియు పరిమితులను నిర్వహించడం
OpenAI రేట్ లిమిట్లను అనేక విధాలుగా కొలుస్తుంది, నిమిషానికి రిక్వెస్ట్లు మరియు నిమిషానికి టోకెన్లు సహా, మరియు ముందుగా ఏది అయిపోతే అది మీకు తగులుతుంది. ఏదైనా దాటినప్పుడు, API Retry-After హెడర్తో 429 ఇస్తుంది. ఆ విలువను కనీస సమయంగా పరిగణించి, క్లయింట్లు అందరూ ఒకేసారి మళ్లీ ప్రయత్నించకుండా చిన్న రాండమ్ ఆలస్యం జోడించమని OpenAI డాక్స్ చెబుతాయి.
ఇవి కూడా ప్లాన్ చేయండి:
- పొడవైన జనరేషన్లపై టైమ్అవుట్లు. స్ట్రీమింగ్ సహాయపడుతుంది, మరియు సహేతుకమైన అవుట్పుట్ పరిమితి కూడా.
- ప్రొవైడర్ అవుటేజ్లు. AI ఫీచర్ పేజీని విరగ్గొట్టకుండా గ్రేస్ఫుల్గా విఫలమవ్వాలి.
- చెడ్డ అవుట్పుట్. స్ట్రక్చర్డ్ అవుట్పుట్ను సేవ్ చేయడానికి ముందు ధృవీకరించండి, మరియు మీ కోడ్లో తనిఖీ లేకుండా మోడల్ అవుట్పుట్ సున్నితమైన చర్యలను ట్రిగ్గర్ చేయకుండా చూడండి.
సాధారణ తప్పులు
- ఫ్రంటెండ్లో లేదా రిపాజిటరీలో కీ. బ్రౌజర్ కోడ్ బహిరంగం, మరియు లీక్ అయిన కీని నిమిషాల్లోనే దుర్వినియోగం చేయవచ్చు. API కీలను ఎలా సురక్షితంగా ఉంచాలి చూడండి.
- స్పెండ్ లిమిట్ లేకపోవడం. లూప్ లేదా దుర్వినియోగం చేసే యూజర్ త్వరగా పెద్ద బిల్లు తెచ్చుకోవచ్చు.
- ప్రతి-యూజర్ లిమిట్లు లేకపోవడం. మీ ప్రొవైడర్ లిమిట్ మీ వాలెట్ను రక్షిస్తుంది, మీ ఇతర యూజర్లను కాదు.
- భద్రత కోసం ప్రాంప్ట్ను నమ్మడం. యూజర్లు “ముందు సూచనలను విస్మరించు” అని టైప్ చేయవచ్చు. అనుమతులు సర్వర్ కోడ్లోనే ఉండాలి.
- అవసరమైనదానికంటే ఎక్కువ పంపడం. మొత్తం డాక్యుమెంట్లు మరియు పొడవైన హిస్టరీలు ఖర్చును గుణిస్తాయి. టాస్క్కు అవసరమైనది మాత్రమే పంపండి.
- మోడల్ పేరును హార్డ్-కోడ్ చేయడం. మోడళ్లు అప్డేట్ అవుతాయి మరియు రిటైర్ అవుతాయి; దాన్ని సెట్టింగ్గా చేయండి.
- వ్యక్తిగత డేటాను ఆలోచించకుండా పంపడం. OpenAI డేటా-వినియోగ నిబంధనలు చదవండి మరియు ఫీచర్కు అవసరమైనది మాత్రమే పంపండి.
చెక్లిస్ట్
- టెస్టింగ్ మరియు ప్రొడక్షన్ కోసం వేర్వేరు OpenAI ప్రాజెక్ట్లు (లేదా కీలు)
- కీ సర్వర్ వైపు సీక్రెట్గా నిల్వ చేయబడింది, బ్రౌజర్ కోడ్ లేదా రిపోలో ఎప్పుడూ కాదు
- స్పెండ్ అలర్ట్లు మరియు కఠినమైన స్పెండ్ లిమిట్ సెట్ చేయబడ్డాయి
- అన్ని కాల్స్ మీ సర్వర్ ద్వారా వెళ్తాయి మరియు యూజర్ అనుమతులను తనిఖీ చేస్తాయి
- అవుట్పుట్ పొడవు పరిమితం చేయబడింది; మోడల్ పేరు కాన్ఫిగర్ చేయదగినది
- మీ యాప్లో ప్రతి-యూజర్ రేట్ లిమిట్
- Retry-After, బ్యాక్ఆఫ్ మరియు జిటర్తో 429 నిర్వహణ
- స్నేహపూర్వక ఎర్రర్ స్థితి; AI లేకుండా పేజీ పని చేస్తుంది
- ఫీచర్ వారీగా టోకెన్ వినియోగం లాగ్ చేయబడింది
- పొడవైన, ఖాళీ మరియు శత్రుత్వ ఇన్పుట్లతో పరీక్షించబడింది
Mythex లో OpenAI API ను వాడటం
మీరు Mythex పై నిర్మించే యాప్లలోని AI ఫీచర్లు మీ స్వంత OpenAI కీని ఉపయోగిస్తాయి, మరియు అవి Mythex బిల్డ్ క్రెడిట్స్కు కాకుండా మీ OpenAI ఖాతాకు బిల్ చేయబడతాయి. /secrets, ప్రాజెక్ట్ సెట్టింగ్లు లేదా ఏజెంట్ కీ అవసరమైనప్పుడు చూపించే సీక్రెట్స్ కార్డ్ ద్వారా OPENAI_API_KEY ను ప్రాజెక్ట్ సీక్రెట్గా జోడించండి, తర్వాత పైన ఉన్నట్లుగా ప్రాంప్ట్తో ఫీచర్ వివరించండి. లైవ్ యాప్లో సీక్రెట్స్ మార్చిన తర్వాత, అది వాటిని పికప్ చేయడానికి మళ్లీ పబ్లిష్ చేయండి. డాక్స్ రెసిపీ మీ స్వంత API కీలతో AI ఫీచర్లు జోడించడం లో స్టార్టర్ ప్రాంప్ట్ ఉంది, మరియు చాట్లో సీక్రెట్స్ సీక్రెట్స్ కార్డ్ను వివరిస్తుంది. ప్రొవైడర్లను పోలుస్తున్నారా? అదే అంశాన్ని Claude కోసం Claude API ను ఎలా ఇంటిగ్రేట్ చేయాలి కవర్ చేస్తుంది.
ప్రశ్నలు
కొత్త యాప్ కోసం ఏ OpenAI API ఉపయోగించాలి?
సెప్టెంబర్ 2026 నాటికి, OpenAI యొక్క క్విక్స్టార్ట్ కొత్త ప్రాజెక్ట్లకు ప్రారంభ బిందువుగా Responses API ను చూపిస్తుంది, దాని అధికారిక SDKలలో client.responses.create() ఉదాహరణలతో. ప్రారంభించే ముందు ప్రస్తుత సిఫార్సు కోసం OpenAI డాక్యుమెంటేషన్ చూడండి.
బ్రౌజర్ నుంచి OpenAI API ను కాల్ చేయవచ్చా?
మీ సీక్రెట్ కీతో కాదు. ఎవరైనా బ్రౌజర్ కోడ్ చదివి కీని తిరిగి వాడి మీ బిల్లును పెంచవచ్చు. బ్రౌజర్ మీ స్వంత సర్వర్ రూట్ను కాల్ చేయాలి, మరియు మీ సర్వర్ కీని ఎన్విరాన్మెంట్ వేరియబుల్గా నిల్వ చేసి OpenAI ను కాల్ చేయాలి.
OpenAI API ఎక్కువ ఖర్చు కాకుండా ఎలా ఆపాలి?
లిమిట్స్ పేజీలో OpenAI యొక్క ప్రొడక్షన్ గైడ్ స్పెండ్ అలర్ట్లు మరియు కఠినమైన నెలవారీ స్పెండ్ లిమిట్ సిఫార్సు చేస్తుంది. మీ యాప్లో రిప్లై పొడవును పరిమితం చేయండి, ప్రతి యూజర్ రిక్వెస్ట్లను పరిమితం చేయండి, మరియు టోకెన్ వినియోగాన్ని లాగ్ చేయండి, ఏ ఫీచర్లు ఎక్కువ ఖర్చు చేస్తున్నాయో చూడటానికి.
OpenAI నుంచి 429 ఎర్రర్ అంటే ఏమిటి?
అంటే మీరు రేట్ లిమిట్ను చేరుకున్నారు. OpenAI యొక్క రేట్-లిమిట్ డాక్స్ ప్రకారం రిస్పాన్స్లో Retry-After హెడర్ ఉంటుంది; కనీసం అంతసేపు వేచి ఉండండి, చిన్న రాండమ్ ఆలస్యం జోడించండి, మరియు ఎక్స్పోనెన్షియల్ బ్యాక్ఆఫ్తో మళ్లీ ప్రయత్నించండి.