Τι είναι ένα API συμβατό με το OpenAI;

Πολλοί πάροχοι LLM και self-hosted servers inference — το ίδιο το OpenAI, το Azure OpenAI, το Groq, το OpenRouter, το Together AI, το Mistral, το DeepSeek, το vLLM, ο server του llama.cpp, το LM Studio και η λειτουργία συμβατότητας με OpenAI του Ollama — εκθέτουν όλοι το ίδιο REST interface που έγινε δημοφιλές από το OpenAI: αιτήματα JSON σε endpoints όπως το /v1/chat/completions, με έλεγχο ταυτότητας μέσω ενός Bearer token στην κεφαλίδα Authorization. Αυτό σας επιτρέπει να αλλάζετε πάροχο χωρίς να ξαναγράψετε τον κώδικα ενσωμάτωσης.

Η χειροκίνητη σύνταξη μιας σωστής εντολής cURL για αυτά τα endpoints απαιτεί να είναι απολύτως σωστά το URL, οι κεφαλίδες και το σώμα JSON, ειδικά κατά τη ρύθμιση παραμέτρων δειγματοληψίας όπως η θερμοκρασία και οι ποινές ή κατά την εναλλαγή μεταξύ αιτημάτων chat, παλαιού τύπου completions και embeddings.

Περιγραφή εργαλείου

Αυτό το εργαλείο δημιουργεί έτοιμες προς χρήση εντολές cURL για οποιοδήποτε API συμβατό με το OpenAI. Ορίστε το βασικό URL, το endpoint, το μοντέλο και τις παραμέτρους και λάβετε αμέσως μια σωστά μορφοποιημένη εντολή cURL, έτοιμη για επικόλληση στο τερματικό ή στα script σας.

Παραδείγματα

Ολοκλήρωση chat:

curl -X POST "https://api.openai.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "gpt-4o-mini",
  "messages": [
    { "role": "system", "content": "Είστε ένας βοηθητικός βοηθός προγραμματισμού." },
    { "role": "user", "content": "Γράψτε μια συνάρτηση Python για την αντιστροφή ενός string" }
  ],
  "temperature": 0.3,
  "stream": false
}'

Self-hosted server (vLLM, llama.cpp, LM Studio, ...):

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "llama-3-8b-instruct",
  "messages": [
    { "role": "user", "content": "Συνοψίστε την πλοκή του Άμλετ σε δύο προτάσεις" }
  ],
  "stream": true
}'

Embeddings:

curl -X POST "https://api.openai.com/v1/embeddings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "text-embedding-3-small",
  "input": "Η γρήγορη καφέ αλεπού πηδά πάνω από τον τεμπέλη σκύλο"
}'

Δυνατότητες

  • Υποστηρίζει τα τρία πιο συνηθισμένα endpoints που είναι συμβατά με το OpenAI: /chat/completions, /completions και /embeddings
  • Λειτουργεί με οποιοδήποτε συμβατό βασικό URL, επομένως είναι κατάλληλο για OpenAI, Azure, Groq, OpenRouter, Together AI και self-hosted servers
  • Ρυθμιζόμενες παράμετροι δειγματοληψίας: θερμοκρασία, top-p, ποινή συχνότητας, ποινή παρουσίας, μέγιστος αριθμός token, αριθμός completions, ακολουθίες διακοπής και seed
  • Προαιρετική μορφή απόκρισης ως αντικείμενο JSON για completions chat
  • Δεν αποστέλλεται τίποτα πουθενά — η εντολή cURL δημιουργείται εξ ολοκλήρου στο πρόγραμμα περιήγησής σας και κανένα API key δεν εγκαταλείπει ποτέ τη συσκευή σας

Επεξήγηση επιλογών

Επιλογή Περιγραφή Προεπιλογή Εύρος
Βασικό URL Η ρίζα του API, χωρίς τη διαδρομή του endpoint. https://api.openai.com/v1 Οποιοδήποτε URL
Endpoint Το endpoint του API στο οποίο θα σταλεί το αίτημα. /chat/completions chat, completions, embeddings
Θερμοκρασία Ελέγχει την τυχαιότητα της εξόδου. Οι χαμηλότερες τιμές παράγουν πιο εστιασμένο κείμενο, ενώ οι υψηλότερες αυξάνουν τη δημιουργικότητα. 1 0-2
Top P Κατώφλι δειγματοληψίας πυρήνα. Το μοντέλο λαμβάνει υπόψη τα token των οποίων η αθροιστική πιθανότητα φτάνει αυτήν την τιμή. 1 0-1
Ποινή συχνότητας Επιβάλλει ποινή στα token ανάλογα με το πόσο συχνά έχουν ήδη εμφανιστεί, μειώνοντας την αυτούσια επανάληψη. 0 -2-2
Ποινή παρουσίας Επιβάλλει ποινή στα token που έχουν ήδη εμφανιστεί έστω και μία φορά, ενθαρρύνοντας το μοντέλο να εισάγει νέα θέματα. 0 -2-2
Μέγιστος αριθμός token Ο μέγιστος αριθμός token που θα δημιουργηθούν στην απόκριση. Αφήστε το πεδίο κενό για παράλειψη και χρήση της προεπιλογής του παρόχου. - Οποιοσδήποτε ακέραιος
Completions (n) Πόσες επιλογές chat/completion θα δημιουργηθούν για την είσοδο. 1 Οποιοσδήποτε ακέραιος
Seed Σταθερό seed για αναπαραγώγιμη έξοδο κατά το δυνατόν. Αφήστε το πεδίο κενό για τυχαία αποτελέσματα. - Οποιοσδήποτε ακέραιος
Ακολουθίες διακοπής Λίστα ακολουθιών διαχωρισμένων με κόμματα, στις οποίες το API σταματά να δημιουργεί επιπλέον token. - Οποιοδήποτε κείμενο
Μορφή απόκρισης Ορίστε την επιλογή σε αντικείμενο JSON για να υποχρεώσετε το μοντέλο να επιστρέψει έγκυρη έξοδο JSON (μόνο για το endpoint chat). Καμία Καμία / αντικείμενο JSON
Ροή Όταν είναι ενεργοποιημένη, η απόκριση μεταδίδεται ως server-sent events. Απενεργοποιήστε την για να λάβετε ολόκληρη την απόκριση μονομιάς. Απενεργοποιημένη Ενεργοποιημένη / Απενεργοποιημένη