OpenAI API-ni Öz Tətbiqinizə Əlavə Etmək — Başlanğıc Bələdçi

OpenAI API-ni Öz Tətbiqinizə Əlavə Etmək — Başlanğıc Bələdçi

Salam, developer dostlar! 👋

Bakıda son bir ildə AI mövzusu partlayıb. LinkedIn-də "AI Engineer" vakansiyaları artıb, Kapital Bank-dan tutmuş kiçik startaplara qədər hər kəs öz məhsuluna süni intellekt əlavə etmək istəyir. Əgər sən də "GPT-ni öz tətbiqimə necə qoşum?" sualını verirsənsə — düz yerə gəlmisən.

Bu məqalədə OpenAI API-ni sıfırdan öz layihənə necə inteqrasiya edəcəyini göstərəcəm. Real kod, real qiymətlər, real məsləhətlər.

---

Niyə OpenAI API?

ChatGPT-ni brauzerdə istifadə etmək başqa şeydir, API ilə öz tətbiqinə qoşmaq tamam başqa. API sənə imkan verir:

• Öz chatbot-unu yarat (müştəri dəstəyi, FAQ cavablayıcı)
• Mətn analizi et (rəyləri pozitiv/neqativ ayır)
• Kod generasiya et (daxili toollar üçün)
• Məzmun yarat (marketinq, tərcümə, xülasə)

Azərbaycanda artıq bir neçə şirkət — məsələn, fintex startaplar və e-ticarət platformaları — müştəri sorğularını avtomatlaşdırmaq üçün GPT API istifadə edir. Bu bacarıq sənin CV-ni ciddi şəkildə gücləndirir. Bakıda AI inteqrasiya bacarığı olan backend developer üçün maaş diapazonu təxminən 1500-3500 AZN arasındadır, adi backend rollarından 30-40% yuxarı.

---

Addım 1: API Key Almaq

1. platform.openai.com saytına daxil ol
2. Hesab yarat və ya Google ilə giriş et
3. Sol menyudan API Keys bölməsinə keç
4. "Create new secret key" düyməsinə bas
5. Key-i dərhal kopyala və təhlükəsiz yerdə saxla (bir daha göstərilməyəcək!)

⚠️ Vacib: Key-i heç vaxt GitHub-a push etmə. .env faylında saxla, .gitignore-a əlavə et. Bakı developer qruplarında hər ay kimsə açıq repo-ya key push edib, sonra $200 faktura görür. Olma o adam.

---

Addım 2: Qiymətləndirmə — Nə Qədər Xərcləyəcəksən?

OpenAI token əsaslı qiymətləndirmə istifadə edir. 2026 mart tarixinə olan qiymətlər:

Praktiki hesab: Orta bir chatbot günə 500 sorğu alırsa və hər sorğu ~800 token istifadə edirsə, gpt-4o-mini ilə aylıq xərcin təxminən $8-12 olar. Bu, bir Bravo-dan alınan nahardır. Yəni eksperiment üçün mükəmməl.

İlk dəfə qeydiyyatdan keçəndə OpenAI sənə $5 pulsuz kredit verir (müddətli). Başlamaq üçün kifayətdir.

---

Addım 3: Python ilə İlk API Çağırışın

Əvvəlcə kitabxananı quraşdır:

bashKopyala
pip install openai python-dotenv

.env faylı yarat:

OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxx

İndi əsas kodu yazaq:

pythonKopyala
import os
from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()

client = OpenAI(
    api_key=os.getenv("OPENAI_API_KEY")
)

def ask_gpt(user_message: str) -> str:
    """İstifadəçi mesajını GPT-yə göndərib cavab alır."""
    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {
                "role": "system",
                "content": "Sən Azərbaycan dilində cavab verən köməkçi assistantsan. Qısa və konkret cavab ver."
            },
            {
                "role": "user",
                "content": user_message
            }
        ],
        max_tokens=500,
        temperature=0.7
    )
    return response.choices[0].message.content


# Test edək
if __name__ == "__main__":
    cavab = ask_gpt("Bakıda ən yaxşı coworking məkanları hansılardır?")
    print(cavab)

Bu kodu main.py kimi saxla və terminalda python main.py ilə işə sal. İlk AI cavabını alacaqsan! 🎉

---

Addım 4: Flask ilə API Endpoint Yaratmaq

Real tətbiqdə bunu REST API kimi istifadə edəcəksən. Sadə Flask nümunəsi:

pythonKopyala
from flask import Flask, request, jsonify
from openai import OpenAI
import os
from dotenv import load_dotenv

load_dotenv()

app = Flask(__name__)
client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))

@app.route("/api/chat", methods=["POST"])
def chat():
    data = request.get_json()
    user_msg = data.get("message", "")

    if not user_msg:
        return jsonify({"error": "Mesaj boş ola bilməz"}), 400

    response = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[
            {"role": "system", "content": "Qısa və faydalı cavab ver."},
            {"role": "user", "content": user_msg}
        ],
        max_tokens=300
    )

    answer = response.choices[0].message.content
    return jsonify({"reply": answer})


if __name__ == "__main__":
    app.run(debug=True, port=5000)

Test etmək üçün:

bashKopyala
curl -X POST http://localhost:5000/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Python nədir?"}'

---

Addım 5: Production Üçün Məsləhətlər

Kodu yazdın, işləyir. Amma production-a çıxmazdan əvvəl bu şeyləri mütləq et:

✓ Rate Limiting

İstifadəçilərin API-ni suistifadə etməsinin qarşısını al. flask-limiter istifadə et — məsələn, hər istifadəçiyə dəqiqədə 10 sorğu.

✓ Error Handling

OpenAI serveri bəzən 429 (rate limit) və ya 500 xətası qaytarır. try/except ilə tutub istifadəçiyə normal mesaj göstər.

pythonKopyala
from openai import RateLimitError, APIError

try:
    response = client.chat.completions.create(...)
except RateLimitError:
    return jsonify({"error": "Çox sorğu göndərdiniz, bir az gözləyin"}), 429
except APIError as e:
    return jsonify({"error": "Xidmət müvəqqəti əlçatmazdır"}), 503

✓ Caching

Eyni suala hər dəfə API çağırma. Redis ilə cavabları cache et — həm sürəti artırar, həm xərci azaldar.

✓ Token Limiti İzlə

max_tokens parametrini düzgün qur. Dashboard-dan istifadəni izlə. Büdcə limiti qoy — OpenAI panel-dən aylıq limit təyin edə bilərsən.

✓ Streaming (İstəyə bağlı)

Uzun cavablar üçün stream=True parametri istifadə et. ChatGPT-dəki kimi cavab hərfi-hərfi gəlir — UX çox yaxşılaşır.

---

Növbəti Addımlar

Bu bələdçi ilə əsası öyrəndin. Daha irəli getmək istəyirsənsə:

• Function Calling — GPT-yə öz funksiyalarını çağırtdır (verilənlər bazasından məlumat çək, API çağır)
• Assistants API — Daha mürəkkəb, kontekst saxlayan agentlər yarat
• Embeddings — Öz sənədlərin üzərində axtarış (RAG arxitekturası)
• Fine-tuning — Modeli öz datanla öyrət

---

Son Söz

OpenAI API-ni layihənə əlavə etmək artıq "gələcək texnologiya" deyil — bu gün Bakıda işə düzəlmək üçün real üstünlükdür. Portfelinə bir GPT-powered layihə əlavə et, GitHub-a push et, LinkedIn-də paylaş. Kapital Bank, ABB, Azerconnect kimi şirkətlər bu bacarıqlara baxır.

Sualın varsa — şərhlərdə yaz, cavablandıracam. Kod yazmağa başla, qalanı gələr. 🚀

Müəllif: Baku Stack redaksiyası | 30 mart 2026