Gemini API: πώς να αποκτήσετε ένα κλειδί, να καλέσετε το μοντέλο και τι κοστίζουν τα διακριτικά

Το Gemini API είναι ο τρόπος με τον οποίο καλείτε μοντέλα Gemini από τον δικό σας κώδικα αντί για ένα παράθυρο συνομιλίας: ένα bot υποστήριξης στον ιστότοπό σας, ένα σενάριο που διαβαθμίζει τα εισιτήρια, τη συμπλήρωση κώδικα σε ένα πρόγραμμα επεξεργασίας, μια ενοποίηση CRM. Η κλασική διαδρομή απαιτεί λογαριασμό Google, ρύθμιση χρέωσης στο cloud και ξένη κάρτα. Στο NeuralSpace η διαδρομή είναι πιο σύντομη: δημιουργείται ένα κλειδί στον πίνακα εργαλείων σας σε περίπου ένα λεπτό, το μοντέλο καλείται με αίτημα συμβατό με OpenAI και πληρώνετε από ένα υπόλοιπο συμβολικών — χωρίς συνδρομή. Ακολουθεί ένας οδηγός βήμα προς βήμα: πώς να αποκτήσετε ένα κλειδί, πώς είναι η πρώτη σας κλήση στο Gemini 3.8 Flash και τι κοστίζουν τα διακριτικά.

Τι είναι το Gemini API και ποιος το χρειάζεται

Το Gemini είναι η οικογένεια γλωσσικών μοντέλων της Google. Μέσω του API είναι ανοιχτό στους προγραμματιστές: στέλνετε μια σειρά από μηνύματα, λαμβάνετε μια απάντηση που δημιουργείται και τη χρησιμοποιείτε στο προϊόν σας — το εμφανίζετε στον χρήστη, το αποθηκεύετε, το επεξεργάζεστε περαιτέρω. Τυπικές περιπτώσεις χρήσης: υποστήριξη chatbot, σύνοψη email και εγγράφων, εξαγωγή δομημένων δεδομένων από κείμενο, σύνταξη περιεχομένου, αυτοματοποίηση ρουτίνας σε σενάρια. Το Gemini 3.8 Flash στον κατάλογο NeuralSpace είναι ο γρήγορος κλάδος της οικογένειας: μια ισορροπία ταχύτητας και τιμής που ταιριάζει σε διαλόγους και μαζική επεξεργασία κειμένου.

Βήμα 1. Πάρτε ένα κλειδί

1. Εγγραφείτε στο NeuralSpace με το email σας — διαρκεί λιγότερο από ένα λεπτό. Στους νέους χρήστες πιστώνονται τα διακριτικά εκκίνησης αμέσως, αρκετά για τις πρώτες κλήσεις API χωρίς ανανέωση.
2. Ανοίξτε τοΣελίδα κλειδιών APIστον πίνακα ελέγχου σας και δημιουργήστε ένα κλειδί. Το κλειδί μοιάζει με nsk-… και εμφανίζεται μία φορά — αποθηκεύστε το αμέσως σε έναν διαχειριστή κωδικών πρόσβασης ή σε μια μεταβλητή περιβάλλοντος, όχι στο αποθετήριο σας.
3. Ελέγξτε το υπόλοιπό σας: τα μοντέλα κειμένου απαιτούν τουλάχιστον 50 διακριτικά στο λογαριασμό. Οι ανανεώσεις γίνονται στον πίνακα εργαλείων — χωρίς ξένες κάρτες, χωρίς τέλη συνδρομής.

Βήμα 2. Καλέστε το μοντέλο

Το Gemini στο δημόσιο API λειτουργεί μέσω του συμβατού με OpenAI τελικό σημείο POST /v1/chat/completions: το σώμα φέρει το μοντέλο, έναν πίνακα messages με ρόλους συστήματος / χρήστη / βοηθού και το όριο max_tokens. Ένα ελάχιστο αίτημα για μπούκλες:

curl https://neuralspace.pro/v1/chat/completions \
  -H "Authorization: Bearer nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "gemini-3-8-flash",
    "messages": [{"role": "user", "content": "Suggest three names for a neural network channel"}],
    "max_tokens": 500
  }'

Η απάντηση επιστρέφει σε μορφή OpenAI: το κείμενο που δημιουργείται είναι σε choices[0].message.content, η πραγματική χρήση είναι σε usage. Εάν έχετε ήδη κώδικα OpenAI SDK, αλλάζουν ακριβώς δύο τιμές — base_url και το κλειδί:

from openai import OpenAI

client = OpenAI(
    base_url="https://neuralspace.pro/v1",
    api_key="nsk-your_key",
)

resp = client.chat.completions.create(
    model="gemini-3-8-flash",
    messages=[
        {"role": "system", "content": "You answer technical questions briefly."},
        {"role": "user", "content": "How is streaming different from a regular response?"},
    ],
)
print(resp.choices[0].message.content)

Οι διεπαφές συνομιλίας επωφελούνται από τη ροή: προσθέστε "stream": true και η απάντηση έρχεται σε κομμάτια μέσω συμβάντων που απεστάλησαν από τον διακομιστή, ώστε ο χρήστης να βλέπει τις πρώτες λέξεις πριν ολοκληρωθεί η δημιουργία.

Βήμα 3. Μάθετε πόσο κοστίζει

Η χρέωση μετριέται: τα διακριτικά εισόδου (η προτροπή σας) και τα διακριτικά εξόδου (η απάντηση του μοντέλου) υπολογίζονται ξεχωριστά, το καθένα με τη δική του τιμή ανά εκατομμύριο. Για το Gemini 3.8 Flash, τη στιγμή της σύνταξης, είναι 33,5 μάρκες ανά εκατομμύριο είσοδο και 168 μάρκες ανά εκατομμύριο έξοδο. Ένα τυπικό αίτημα "2.000 διακριτικά περιβάλλοντος + 500 μάρκες εξόδου" κοστίζει περίπου 0,15 μάρκες. Η τιμή συνδέεται με τη συναλλαγματική ισοτιμία και κυμαίνεται, επομένως ελέγξτε τον ζωντανό πίνακα πριν κάνετε τα μαθηματικά: δημοσιεύεται στοΣελίδα τεκμηρίωσης APIκαι επιστράφηκε σε αναγνώσιμη από μηχανή μορφή από GET /v1/models. Για σύγκριση: Το DeepSeek V4 Flash στον ίδιο κατάλογο είναι 21/42 tokens ανά εκατομμύριο, τα μοντέλα Claude είναι αισθητά πιο ακριβά. Το Gemini 3.8 Flash βρίσκεται στη μέση της τιμής ενώ απαντά γρήγορα.

Δύο όρια υπηρεσιών: 60 αιτήματα ανά λεπτό ανά κλειδί και ελάχιστο υπόλοιπο 50 κουπονιών για μοντέλα κειμένου. Το τρέχον υπόλοιπο είναι διαθέσιμο μέσω GET /v1/balance, οι χρεώσεις εμφανίζονται στο ιστορικό συναλλαγών του προφίλ σας.

Δίδυμοι στον ιστότοπο — δεν απαιτείται κωδικός

Εάν δεν χρειάζεστε ακόμα το API, τα ίδια μοντέλα ζουν στη διεπαφή: επιλέξτε Gemini 3.8 Flash στοκουβέντα— η αναζήτηση ιστού είναι ενεργοποιημένη εκεί — και για εικόνες τοδημιουργία εικόναςΗ ενότητα προσφέρει το Nano Banana, ένα μοντέλο που βασίζεται στο Gemini 2.5 Flash. Το υπόλοιπο είναι κοινόχρηστο: η συνομιλία και το API αντλούν από τον ίδιο λογαριασμό.

Συνήθη σφάλματα πρώτου αιτήματος

• 401 Μη εξουσιοδοτημένο— το κλειδί πέρασε λανθασμένα: ένα επιπλέον διάστημα, μια περικομμένη τιμή, ένα λάθος πρόθεμα. Το πλήρες κλειδί πηγαίνει μετά το Bearer ή στην κεφαλίδα x-api-key.
• 429 Πάρα πολλά αιτήματα— έχετε φτάσει στο όριο των 60 αιτημάτων ανά λεπτό. Προσθέστε μια παύση ή μια ουρά από την πλευρά σας.
• Σφάλμα ισορροπίας— λιγότερα από 50 διακριτικά στον λογαριασμό: συμπληρώστε τον πίνακα ελέγχου και δοκιμάστε ξανά.
• Το κλειδί διέρρευσε στο git— κρατήστε το σε μεταβλητές περιβάλλοντος (.env) και μην το δεσμεύσετε ποτέ. Εάν διαρρεύσει, επανεκδώστε το κλειδί στην ίδια σελίδα κλειδιών API.

FAQ

Χρειάζομαι λογαριασμό Google ή ξένη κάρτα;

Όχι. Το κλειδί εκδίδεται στον πίνακα εργαλείων του NeuralSpace και πληρώνετε από ένα υπόλοιπο διακριτικών: χρέωση βάσει διακριτικών, χωρίς συνδρομή, χωρίς χρέωση στο cloud.

Πόσο κοστίζει μια κλήση API Gemini;

Μόνο τα πραγματικά διακριτικά: τη στιγμή της σύνταξης, 33,5 μάρκες ανά εκατομμύριο είσοδο και 168 ανά εκατομμύριο έξοδος για το Gemini 3,8 Flash. ένα αίτημα για μερικές χιλιάδες μάρκες είναι περίπου 0,15 μάρκες. Οι τρέχουσες τιμές είναι σε GET /v1/models και στον πίνακα τεκμηρίωσης.

Υπάρχει δωρεάν βαθμίδα;

Δεν υπάρχουν ελεύθερες γενιές στην πλατφόρμα. Οι νέοι χρήστες λαμβάνουν μάρκες εκκίνησης — αρκετά για τα πρώτα πειράματα — μετά από αυτό πληρώνετε ανά διακριτικό χωρίς χρέωση συνδρομής.

Τι άλλο μπορεί να κάνει το API εκτός από κείμενο;

Με το ίδιο κλειδί λαμβάνετε δημιουργία εικόνας, βίντεο και μουσικής, σύνθεση και αναγνώριση ομιλίας και διακομιστή MCP στη διεύθυνση https://neuralspace.pro/mcp για πράκτορες AI. Η πλήρης λίστα τελικών σημείων βρίσκεται στην τεκμηρίωση.