OpenAI API-г аппдаа хэрхэн холбох вэ

OpenAI API-г холбохын тулд OpenAI проектод API түлхүүр үүсгэж, түүнийг OPENAI_API_KEY нэртэй сервер талын нууц болгон хадгалаад, API-г хөтчийн кодоос бүү, харин өөрийн серверийн route-оос OpenAI-ийн албан ёсны SDK-аар дууд. 2026 оны 9-р сарын байдлаар OpenAI-ийн quickstart нь шинэ проектуудын эхлэлийн цэг болгон Responses API-г танилцуулдаг. Эхлэхийн өмнө зардлын хязгаар тавьж, хариултын уртыг хязгаарла, хэрэглэгч бүр функцийг хэр олон удаа дуудаж болохыг хязгаарла, мөн rate-limit алдааг дахин оролтоор зохицуул.

Энэ гарын авлага тохиргоо, хүсэлтийн урсгал, AI builder-т өгөх prompt-ууд, түлхүүр алдагдуулах эсвэл мөнгө үрэх алдааг хамруулна. OpenAI-ийн мэдээлэл 2026 оны 9-р сарын байдлаар албан ёсны баримтад үндэслэсэн. Ерөнхий ойлголтууд (токен, context window, үнэ)-ийн талаар эхлээд LLM API-г хэрхэн ашиглах вэ-г уншина уу.

Үүгээр юу бүтээж болох вэ

• Аппдаа суулгасан чатын туслах (AI чатботын апп хэрхэн бүтээх вэ)
• «Хураангуйлах», «дахин бичих» эсвэл «хариултын ноорог гаргах» товчнууд
• Чөлөөт текстээс бүтэцтэй өгөгдөл гаргах: имэйлийг захиалга болгох, support тасалбарыг тэмдэглэх
• Таны өөрийн агуулгаас хайлт болон асуултанд хариулах
• Загвар боломжоос хамаарч зураг үүсгэх, яриа таних болон бусад медиа функцууд

Илүү санаа аппдаа AI функц нэмэх нь-д байна.

OpenAI дансаа тохируулах

1. OpenAI платформ дээр данс болон проект үүсгэ. OpenAI-ийн продакшны шилдэг практик нь staging болон продакшнд тус тусдаа проект байхыг зөвлөдөг, ингэснээр тус бүр өөрийн түлхүүр, хязгаартай байна.
2. Проектын API түлхүүр үүсгэ. OpenAI нь хугацаа заах болон түлхүүрээ тогтмол солихыг зөвлөдөг.
3. Зардлын мэдэгдэл болон хатуу зардлын хязгаарыг limits хуудсан дээр тавь. OpenAI-ийн гарын авлагад мэдэгдэл нь хэрэглээ тодорхой дүнг давахад мэдэгдэж, хатуу хязгаар нь сарын дээд хязгаарыг мөрддөг гэж заасан.
4. Төлбөр нэм. OpenAI-ийн rate-limit баримтад хэрэглээний түвшнүүдийг тайлбарласан: цаг хугацааны явцад илүү их зарцуулахаар таны хязгаар автоматаар өсдөг.

Хүсэлтийн урсгал

Хөтөч  ->  таны серверийн route  ->  OpenAI API
       <-  (стримлэгдсэн) хариулт  <-

1. Хэрэглэгч товч дарна эсвэл мессеж илгээнэ.
2. Хөтөч таны route-г дуудна, жишээ нь POST /api/summarise.
3. Таны сервер хэрэглэгч нэвтэрсэн, функцийг ашиглах эрхтэй эсэхийг шалгана.
4. Сервер хүсэлтийг бүрдүүлнэ: заавар, хэрэглэгчийн оролт, даалгаварт хэрэгтэй өгөгдөл.
5. Орчноосоо түлхүүрээр OpenAI-г дуудна. OpenAI-ийн SDK-ууд OPENAI_API_KEY-г автоматаар уншдаг.
6. Хариултыг стриминг хийж буцаана, токений хэрэглээг бүртгэнэ.

OpenAI-ийн албан ёсны SDK багцууд нь JavaScript/TypeScript (npm) болон Python (pip) хоёрт openai нэртэй.

Загвар сонгох

OpenAI өөр өөр үнэ, хурдтай хэд хэдэн загвар санал болгодог бөгөөд жагсаалт нь ихэвчлэн өөрчлөгддөг. Жижиг, хямд загвараас эхэл, бодит жишээн дээр чанарыг хэмж, хэрэгтэй үед л дээш шилжүүл. Загварын нэрийг тохиргооны утга эсвэл нууц болгон хадгалж, кодыг дахин бичихгүйгээр солих боломжтой байлга. Одоогийн үнийг OpenAI-ийн үнийн хуудаснаас шалга.

Сонголт ба ашиг, алдагдал

AI builder-т өгөх prompt-ууд

Анхны функц:

Тасалбарын хуудсан дээр «Хураангуйлах» товч нэм. Энэ нь POST /api/summarise server route-г дуудаж, хэрэглэгч нэвтэрсэн эсэхийг шалгаад, тасалбарыг ачаалж, албан ёсны openai SDK болон OPENAI_API_KEY нууцаар OpenAI Responses API-г дуудна. Загварын нэрийг OPENAI_MODEL нууцаас унш. Заавар: "3 цэгээр хураангуйл, дараа нь богино хариултыг санал болго. Захиалгын дугаар бүү зохио." Гаралтын уртыг хязгаарла, хариултыг хуудсанд стримлэ, мөн түлхүүрийг хөтөч рүү хэзээ ч бүү илгээ.

Хамгаалалт:

Хэрэглэгч бүрт цагт 30 AI хүсэлт хязгаарла, өгөгдлийн санд хадгал. Хүсэлт бүрийн оролт, гаралтын токенүүдийг хэрэглэгчийн ID болон функцийн нэртэй хамт бүртгэ. OpenAI 429 буцаавал Retry-After толгойг дага, exponential backoff ба jitter-ээр дээд тал нь 3 удаа дахин оролд; дараа нь «AI одоогоор завгүй байна, нэг минутын дараа дахин оролдоно уу.» гэж харуул. Бусад алдаанд найрсаг мессеж харуулж, хуудасны бусад хэсэг ажиллаж байхаар үлдээ.

Алдаа ба хязгаарыг зохицуулах

OpenAI rate limit-ийг хэд хэдэн аргаар хэмждэг, тэр дундаа минутад хүсэлт, минутад токен, мөн та аль нь эхэлж дуусахаас хамаарч хязгаартай тулгардаг. Аль нэгийг нь хэтрүүлэхэд API Retry-After толгойтой 429 буцаана. OpenAI-ийн баримтад тэр утгыг доод хугацаа гэж үзэж, жижиг санамсаргүй саатал нэмэхийг зөвлөсөн, ингэснээр үйлчлүүлэгчид бүгд зэрэг дахин оролдохгүй.

Дараах зүйлд бас бэлтгэ:

• Удаан үүсгэлтэй timeout. Стриминг тусална, мөн зохистой гаралтын хязгаар мөн тусална.
• Үйлчилгээ үзүүлэгчийн доголдол. AI функц хуудсыг эвдэхгүйгээр нөхцөл байдлыг зөөлнөөр зохицуулах ёстой.
• Муу гаралт. Бүтэцтэй гаралтыг хадгалахаасаа өмнө шалга, мөн кодонд шалгалтгүйгээр загварын гаралт эмзэг үйлдэл өдөөхгүй байлга.

Түгээмэл алдаанууд

• Түлхүүр фронтэнд эсвэл репозитор дотор. Хөтчийн код нийтэд нээлттэй, алдагдсан түлхүүрийг хэдхэн минутын дотор урвуулан ашиглаж болно. API түлхүүрээ аюулгүй хэрхэн хадгалах вэ-г үз.
• Зардлын хязгааргүй байх. Давталт эсвэл хүчирхийлэгч хэрэглэгч хурдан их нэхэмжлэх үүсгэж чадна.
• Хэрэглэгч бүрийн хязгааргүй байх. Үйлчилгээ үзүүлэгчийн хязгаар таны түрийвчийг хамгаална, бусад хэрэглэгчдээ биш.
• Аюулгүй байдлыг prompt-д найдах. Хэрэглэгч «өмнөх заавруудыг үл тоо» гэж бичиж чадна. Эрх нь серверийн кодонд байх ёстой.
• Хэрэгтэйгээс илүүг илгээх. Бүтэн баримт бичиг, урт түүх зардлыг үржүүлдэг. Даалгаварт хэрэгтэйг л илгээ.
• Загварын нэрийг код дотор хатаах. Загварууд шинэчлэгдэж, зогсоогддог; үүнийг тохиргоо болго.
• Бодолгүйгээр хувийн өгөгдөл илгээх. OpenAI-ийн өгөгдөл ашиглах нөхцөлийг унш, функцэд хэрэгтэйг л илгээ.

Шалгах жагсаалт

• Туршилт ба продакшнд тусдаа OpenAI проект (эсвэл түлхүүр)
• Түлхүүр сервер талын нууцаар хадгалагдсан, хөтчийн код болон репозитор дотор биш
• Зардлын мэдэгдэл болон хатуу зардлын хязгаар тавьсан
• Бүх дуудлага серверээр дамжиж, хэрэглэгчийн эрхийг шалгадаг
• Гаралтын урт хязгаарлагдсан; загварын нэр тохируулах боломжтой
• Аппдаа хэрэглэгч бүрийн rate limit байна
• 429-г Retry-After, backoff, jitter-оор зохицуулдаг
• Найрсаг алдааны төлөв; AI-гүйгээр ч хуудас ажилладаг
• Функц бүрээр токений хэрэглээг бүртгэдэг
• Урт, хоосон, дайсагнасан оролтоор туршсан

OpenAI API-г Mythex-д ашиглах нь

Mythex дээр бүтээсэн аппуудын AI функцүүд таны өөрийн OpenAI түлхүүрээр ажиллаж, Mythex-ийн build кредитээс биш таны OpenAI дансанд төлбөр бодогдоно. OPENAI_API_KEY-г /secrets, төслийн тохиргоо, эсвэл агентын түлхүүр шаардлагатай үед харуулах нууцын карт хэсгээр төслийн нууц болгон нэм, дараа нь дээрх шиг prompt-оор функцээ дүрсэл. Нийтлэгдсэн аппын нууцыг өөрчилсний дараа дахин нийтэл. Docs-ийн Аппдаа AI функцүүдийг өөрийн API түлхүүрээр нэмэх жор эхлэх prompt-тай, мөн Чат дахь нууцууд нь нууцын картыг тайлбарласан. Үйлчилгээ үзүүлэгчдийг харьцуулж байна уу? Claude API-г хэрхэн холбох вэ-г үз.

Асуултууд