Εγκατάσταση του Python SDK
Σε αυτήν τη σελίδα
Εγκατάσταση του Python SDK
Το Python SDK openai αποτελεί την επίσημη βιβλιοθήκη για την αλληλεπίδραση με το API. Αυτό το μάθημα σας καθοδηγεί στη διαδικασία εγκατάστασης και διαμορφώνει μια καθαρή δομή έργου, την οποία θα χρησιμοποιήσετε σε όλη τη διάρκεια του μαθήματος.
Προαπαιτούμενα και Εγκατάσταση
Χρειάζεστε Python 3.10 ή νεότερη έκδοση—την ελάχιστη απαιτούμενη από το SDK openai (έκδοση 3.42.1 στις 2 Νοεμβρίου 2026, σύμφωνα με το PyPI)—έναν διαχειριστή πακέτων (pip ή uv) και το κλειδί API που αποκτήσατε στο προηγούμενο μάθημα. Ξεκινήστε επιβεβαιώνοντας τον διερμηνέα σας, καθώς οι μηχανές ανάπτυξης συχνά φιλοξενούν πολλαπλές εκδόσεις:
python --version
# Python 3.12.4
Η εγκατάσταση απαιτεί μία μόνο εντολή: pip install openai, ή uv pip install openai αν χρησιμοποιείτε το uv, το οποίο είναι σημαντικά ταχύτερο. Ωστόσο, καθιερώστε τη συνήθεια να εργάζεστε μέσα σε εικονικό περιβάλλον (virtual environment). Αυτό αποτρέπει το συχνό φαινόμενο όπου, έξι μήνες αργότερα, ανακαλύπτετε ότι δύο έργα απαιτούν ασύμβατες εκδόσεις της ίδιας βιβλιοθήκης.
# Δημιουργία εικονικού περιβάλλοντος
python -m venv .venv
# Ενεργοποίηση (Linux/macOS)
source .venv/bin/activate
# Ενεργοποίηση (Windows)
.venv\Scripts\activate
# Εγκατάσταση του SDK
pip install openai
Δύο βοηθητικά πακέτα εμφανίζονται σε σχεδόν κάθε έργο και αξίζει να εγκατασταθούν μαζί με το SDK. Το Pydantic βοηθά στον ορισμό σχημάτων για την Δομημένη Έξοδο (Structured Output), την οποία θα δείτε αργότερα, ενώ το python-dotenv φορτώνει το αρχείο .env στις μεταβλητές περιβάλλοντος.
# Εγκατάσταση με υποστήριξη για dataclasses του Pydantic
pip install openai pydantic
# Εγκατάσταση με python-dotenv για μεταβλητές περιβάλλοντος
pip install openai python-dotenv
Τέλος, επαληθεύστε ότι η εισαγωγή λειτουργεί και σημειώστε την εγκατεστημένη έκδοση. Αυτή είναι η πρώτη πληροφορία που πρέπει να παρέχετε εάν ανοίξετε ένα αίτημα υποστήριξης.
import openai
print(f"OpenAI SDK version: {openai.__version__}")
# Output: OpenAI SDK version: 1.68.0 (or newer)
Ένας Πελάτης, Όλα τα APIs
Το SDK περιστρέφεται γύρω από ένα μοναδικό αντικείμενο πελάτη (client) που εκθέτει ολόκληρη την πλατφόρμα μέσω υποενοτήτων. Δεν χρειάζεται να δημιουργήσετε κάτι νέο για να μεταβείτε από τη δημιουργία κειμένου σε ενσωματώσεις (embeddings) ή moderation.
from openai import OpenAI
client = OpenAI()
# Responses API (κείμενο, κλήση συναρτήσεων, δομημένη έξοδος)
client.responses.create(...)
# Chat Completions API (παλαιότερη έκδοση)
client.chat.completions.create(...)
# Embeddings
client.embeddings.create(...)
# Εικόνες
client.images.generate(...)
# Ήχος
client.audio.transcriptions.create(...)
client.audio.speech.create(...)
# Moderation
client.moderations.create(...)
Διαμόρφωση του Πελάτη για το Πλαίσιο Σας
Οι προεπιλογές του SDK λειτουργούν για πειραματισμούς, αλλά είναι ανεπαρκείς για web εφαρμογές. Η προεπιλεγμένη χρονική λήξη (timeout) είναι δέκα λεπτά: σε ένα HTTP API που αναμένεται να αποκρίνεται μέσα σε δευτερόλεπτα, αυτό σημαίνει ότι ένα κολλημένο αίτημα δεσμεύει έναν worker για πολύ περισσότερο από όσο πρέπει. Μειώστε το και αυξήστε τον αριθμό των αυτόματων επαναλήψεων, ο οποίος προεπιλέγεται σε δύο.
from openai import OpenAI
client = OpenAI(
timeout=60.0, # 60 δευτερόλεπτα (προεπιλογή: 10 λεπτά)
max_retries=3, # 3 προσπάθειες σε περίπτωση σφάλματος (προεπιλογή: 2)
)
Η παράμετρος base_url καλύπτει μια άλλη ανάγκη: τη δρομολόγηση κλήσεων μέσω εταιρικού διακομιστή μεσολάβησης (proxy) που καταγράφει την εξερχόμενη κίνηση, ή προς μια υπηρεσία που εκθέτει ένα συμβατό API.
# Χρήσιμο για εταιρικά proxy ή συμβατά APIs
client = OpenAI(
base_url="https://your-proxy.company.com/v1"
)
Τέλος, εάν η εφαρμογή σας βασίζεται στο asyncio—όπως το FastAPI, το aiohttp και παρόμοια—χρησιμοποιήστε το AsyncOpenAI. Ο συγχρονισμένος πελάτης θα μπλοκάριζε τον βρόχο γεγονότων (event loop) κατά τη διάρκεια της δημιουργίας, ακυρώνοντας τα οφέλη του ασύγχρονου κώδικα.
from openai import AsyncOpenAI
async_client = AsyncOpenAI()
# Χρήση με await
import asyncio
async def main():
response = await async_client.responses.create(
model="gpt-5.6-terra",
input="Hello!"
)
print(response.output_text)
asyncio.run(main())
# Output: Hello! How can I help you today?
Δομή του Έργου Σας
Υιοθετήστε μια οργάνωση που απομονώνει τη διαμόρφωση του πελάτη από τον υπόλοιπο κώδικά σας εξαρχής. Αυτό αποφεύγει τη διασπορά δεκάδων κλήσεων OpenAI() σε όλο το έργο σας, καθεμία με τις δικές της ρυθμίσεις.
my-project/
├── .env # Κλειδί API (ΠΟΤΕ μην το κάνετε commit στο git)
├── .gitignore # Περιλαμβάνει το .env
├── requirements.txt # Εξαρτήσεις
├── src/
│ ├── __init__.py
│ ├── client.py # Διαμόρφωση πελάτη OpenAI
│ └── main.py # Σημείο εισόδου
└── tests/
└── test_api.py
Το αρχείο src/client.py κεντροποιεί το εργοστάσιο πελάτη (client factory): την ημέρα που θα αλλάξετε το timeout ή θα προσθέσετε ένα proxy, θα χρειαστεί να τροποποιήσετε μόνο μία τοποθεσία.
from openai import OpenAI
from dotenv import load_dotenv
load_dotenv()
def get_client() -> OpenAI:
"""Επιστρέφει έναν διαμορφωμένο πελάτη OpenAI."""
return OpenAI(
max_retries=3,
timeout=30.0
)
Και το requirements.txt καθορίζει τις ελάχιστες αναμενόμενες εκδόσεις:
openai>=1.60.0
python-dotenv>=1.0.0
pydantic>=2.0.0
Τρία Συχνά Σφάλματα
Ένα ModuleNotFoundError για το openai σχεδόν πάντα υποδηλώνει ένα ανενεργό εικονικό περιβάλλον ή ένα διαφορετικό από εκείνο όπου εγκαταστήσατε το πακέτο. Εντοπίστε τον διερμηνέα που χρησιμοποιείται πραγματικά με την εντολή which python σε Linux και macOS, ή where python σε Windows, και στη συνέχεια επανεγκαταστήστε με pip install --upgrade openai. Ένα AuthenticationError υποδεικνύει πρόβλημα με τη μεταβλητή περιβάλλοντος: εκτυπώστε os.environ.get("OPENAI_API_KEY", "NOT DEFINED") για να αποκλείσετε θέματα—το αρχείο .env δεν φορτώνεται εάν δεν κληθεί το load_dotenv() πριν τη δημιουργία του πελάτη. Τέλος, ένα σφάλμα σχετικά με μια άγνωστη παράμετρο συνήθως υποδεικνύει ότι το SDK είναι πολύ παλιό για τη λειτουργία που χρησιμοποιείτε: pip install --upgrade openai λύνει το πρόβλημα.
Βασικά σημεία
- Εγκαταστήστε το SDK με
pip install openaiμέσα σε εικονικό περιβάλλον - Ο πελάτης
OpenAI()είναι το σημείο εισόδου για όλα τα APIs - Χρησιμοποιήστε το
AsyncOpenAI()για ασύγχρονες εφαρμογές - Διαμορφώστε το timeout και τις επαναλήψεις βάσει των αναγκών σας
- Δομήστε το έργο σας με αρχείο
.envκαι κεντροποιημένο πελάτη