Παιδότοπος API

Διαδραστικό

Δοκιμάστε κάθε μοντέλο και endpoint στον browser με το δικό σας κλειδί — έξοδος με streaming, επιθεωρητής αιτημάτων και παραγόμενος κώδικας που επικολλάτε κατευθείαν στην εφαρμογή σας.

Άνοιγμα του Playground

Το playground είναι μια κονσόλα chat για το API στο /docs/playground. Μιλάτε με ένα μοντέλο και το playground στέλνει τα ίδια αιτήματα που θα έστελνε ο κώδικάς σας: σε ένα από τρία endpoints, με το μοντέλο, το system prompt, τις παραμέτρους και τα εργαλεία που ορίσατε. Κάθε αίτημα μπορεί να διαβαστεί ξανά ως κώδικας και ως ακατέργαστα συμβάντα stream.

Έναρξη

Δώστε του ένα κλειδί — Όταν έχετε συνδεθεί, το playground χρησιμοποιεί το κλειδί API του λογαριασμού σας και δείχνει το υπόλοιπό σας. Αν δεν έχετε συνδεθεί, επιλέξτε Προσθήκη κλειδιού και επικολλήστε ένα κλειδί: μένει μόνο σε αυτή την καρτέλα και δεν αποθηκεύεται ποτέ.
Διαλέξτε endpoint και μοντέλο — Η επάνω γραμμή περιέχει τον διακόπτη endpoint και τον επιλογέα μοντέλου. Μια νέα συνομιλία ξεκινά στο Chat Completions με το shannon-3.
Στείλτε ένα μήνυμα — Πληκτρολογήστε παρακάτω και πατήστε Enter. Κάθε απάντηση προστίθεται στη συνομιλία, οπότε το επόμενο μήνυμα τη συνεχίζει. Η κενή οθόνη προσφέρει τρία έτοιμα prompts εκκίνησης και ένα έτοιμο παράδειγμα κλήσης εργαλείου.

Βρίσκετε και αλλάζετε το κλειδί σας στη σελίδα Κλειδιά & χρήση. Κλειδιά & χρήση

Endpoints και μοντέλα

Ο διακόπτης endpoint αποφασίζει ποια μορφή αιτήματος χτίζει το playground. Μπορείτε να τον αλλάξετε στη μέση μιας συνομιλίας· τα μηνύματα μένουν.

Endpoint	Αίτημα που στέλνει	Αναφορά
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Μορφή Anthropic

Ο επιλογέας μοντέλου απαριθμεί ό,τι επιστρέφει το GET /v1/models. Μπορεί να αναζητηθεί, κρατά τα πρόσφατα μοντέλα σας στην κορυφή και δείχνει για κάθε μοντέλο την τιμή ανά 1M tokens, το παράθυρο συμφραζομένων και σήματα για εργαλεία, είσοδο εικόνας, συλλογισμό και δομημένη έξοδο.

Η συνομιλία

Οι απαντήσεις ρέουν στη συνομιλία καθώς γράφονται. Ο συλλογισμός του μοντέλου εμφανίζεται σε δικό του block που μπορείτε να διπλώσετε.
Κάτω από κάθε απάντηση: χρόνος μέχρι το πρώτο token, tokens ανά δευτερόλεπτο, διάρκεια, tokens εισόδου και εξόδου με τα μέρη cached και συλλογισμού, εκτίμηση του κόστους του γύρου, ο λόγος ολοκλήρωσης και το id απάντησης.
Ένα μήνυμά σας μπορεί να επεξεργαστεί και να σταλεί ξανά από εκείνο το σημείο. Μια απάντηση μπορεί να αναπαραχθεί ξανά. Ένα μήνυμα μπορεί να διαγραφεί και η διαγραφή μπορεί να αναιρεθεί για λίγα δευτερόλεπτα.
Το Διακοπή ή το πλήκτρο Esc τερματίζει μια απάντηση που γράφεται.
Οι εικόνες επισυνάπτονται με το κουμπί εικόνας, με επικόλληση ή με απόθεση αρχείου, για μοντέλα που δέχονται εικόνες. Μια εικόνα μικραίνει στα 1,568 pixels στη μεγάλη της πλευρά πριν σταλεί. Ένα αρχείο πάνω από 30 MB παραλείπεται.
Το πεδίο σύνταξης και το system prompt δείχνουν αριθμό tokens. Για τα φιλοξενούμενα μοντέλα ανοιχτών βαρών είναι ο ακριβής αριθμός από το POST /v1/tokenize. Για τα άλλα μοντέλα είναι εκτίμηση, σημειωμένη με ≈.
Ένα αίτημα που απέτυχε δείχνει τι να κάνετε στη συνέχεια: ορισμό κλειδιού όταν το κλειδί απορρίφθηκε, προσθήκη credit όταν το υπόλοιπο εξαντλήθηκε, τα δευτερόλεπτα αναμονής μετά από πάρα πολλά αιτήματα, ή επανάληψη μετά από σφάλμα διακομιστή.

Ρυθμίσεις αιτήματος

Το κουμπί Ρυθμίσεις ανοίγει ένα πάνελ με έξι καρτέλες. Οι ρυθμίσεις ανήκουν στη συνομιλία: κάθε συνομιλία κρατά τις δικές της.

Καρτέλα	Τι περιέχει
Σύστημα	Το system prompt της συνομιλίας, που στέλνεται με κάθε αίτημα. Πέντε πρότυπα το συμπληρώνουν και εμφανίζεται ο αριθμός των tokens του.
Παράμετροι	Μέγιστα tokens εξόδου, θερμοκρασία, `top_p`, προσπάθεια συλλογισμού, ακολουθίες διακοπής, `seed`, και οι διακόπτες για streaming και αναζήτηση στον ιστό. Ένα χειριστήριο για το οποίο το επιλεγμένο endpoint δεν έχει πεδίο απενεργοποιείται και σημειώνεται.
Εργαλεία	Ορισμοί εργαλείων που στέλνονται με το αίτημα: τέσσερα έτοιμα (`get_weather`, `read_file`, `run_shell`, `web_search`) ή δικός σας ορισμός ως JSON, και `tool_choice` (`auto`, `none`, `required` ή ένα εργαλείο με όνομα). Όταν το μοντέλο καλεί εργαλείο, η συνομιλία δείχνει την κλήση με ένα πλαίσιο για το αποτέλεσμα. Με ενεργό το Προσφορά δειγμάτων αποτελεσμάτων, ένα κλικ συμπληρώνει ένα δείγμα αποτελέσματος. Μπορείτε και να πληκτρολογήσετε δικό σας και μετά να το στείλετε για να συνεχιστεί ο γύρος.
Δομημένο	`response_format`: `text`, `json_object` ή `json_schema` με όνομα schema και ένα JSON schema. Όταν έχει οριστεί schema, η τελευταία απάντηση ελέγχεται με βάση αυτό και σημειώνεται στη συνομιλία ως ταυτιζόμενη ή όχι. Η καρτέλα είναι απενεργοποιημένη στο endpoint Messages, και μια επιλογή που δεν δέχεται το επιλεγμένο μοντέλο δεν προσφέρεται.
Κώδικας	Το αίτημα της τρέχουσας συνομιλίας ως κώδικας cURL, Python, Node ή Go, χτισμένο από τη συνομιλία και τις ρυθμίσεις της. Το κλειδί εμφανίζεται ως `YOUR_API_KEY`. Ο κώδικας μπορεί να αντιγραφεί ή να ανοιχτεί σε μεγάλη προβολή.
Συμβάντα	Ο τελευταίος γύρος όπως πέρασε από το δίκτυο: κάθε συμβάν stream με τη χρονική μετατόπισή του και φίλτρο, η συναρμολογημένη απάντηση, οι κεφαλίδες της απάντησης (`x-request-id`, `content-type`, `retry-after`, `date`) και το σώμα του αιτήματος. Αυτά φυλάσσονται μέχρι να φορτώσει ξανά η σελίδα.

Έλεγχοι εισόδου

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

Ρύθμιση	Έλεγχος
Μέγιστα tokens εξόδου	Ένας ακέραιος από 1 έως το `max_output_tokens` του μοντέλου.
Θερμοκρασία	Ένας αριθμός από 0 έως 2. Αν μείνει κενό, το πεδίο παραλείπεται από το αίτημα.
`top_p`	Ένας αριθμός από 0 έως 1. Αν μείνει κενό, το πεδίο παραλείπεται από το αίτημα.
`seed`	Ένας ακέραιος.
Ακολουθίες διακοπής	Το πολύ 4, χωρισμένες με κόμματα.
`response_format`	Πρέπει να είναι μορφή που δέχεται το επιλεγμένο μοντέλο. Μια συνομιλία που μεταφέρθηκε σε μοντέλο χωρίς `json_schema` ή χωρίς `response_format` δεν στέλνεται και εμφανίζεται ο λόγος.
Εικόνες	Αφαιρούνται από το μήνυμα όταν αλλάζετε σε μοντέλο που δέχεται μόνο κείμενο, με σημείωση.

Σύγκριση δύο μοντέλων

Η επιλογή Σύγκριση δύο μοντέλων στο μενού Περισσότερα προσθέτει δεύτερο επιλογέα μοντέλου. Κάθε μήνυμα πηγαίνει τότε και στα δύο μοντέλα ταυτόχρονα, με τις ίδιες ρυθμίσεις, και οι δύο απαντήσεις εμφανίζονται δίπλα-δίπλα, σημειωμένες ως A και B. Μπορείτε να αναπαράγετε μόνο τη μία πλευρά. Όταν η μία πλευρά καλεί εργαλείο, το αποτέλεσμα που στέλνετε συνεχίζει μόνο εκείνη την πλευρά.

Το Αντιγραφή συνδέσμου κοινοποίησης πακετάρει τη συνομιλία μέσα στον ίδιο τον σύνδεσμο, στο τμήμα μετά το #. Τίποτα δεν ανεβαίνει. Οι εικόνες, το κλειδί σας και τα στοιχεία της τελευταίας εκτέλεσης παραλείπονται. Όποιος ανοίξει τον σύνδεσμο παίρνει τη συνομιλία ως νέα στο δικό του playground.
Μια συνομιλία πολύ μεγάλη για σύνδεσμο απορρίπτεται με σημείωση. Κατεβάστε τη ως JSON.
Το Λήψη JSON συνομιλίας αποθηκεύει τη συνομιλία με τις ρυθμίσεις της ως αρχείο. Το Εισαγωγή JSON στο πάνελ συνομιλιών ανοίγει ένα τέτοιο αρχείο.
Το Αντιγραφή ως cURL αντιγράφει το τρέχον αίτημα ως μία εντολή cURL.

Τι φυλάσσεται πού

Τι	Πού φυλάσσεται
Συνομιλίες, αποθηκευμένα εργαλεία, πρόσφατα μοντέλα, διάταξη πάνελ	Σε αυτό το πρόγραμμα περιήγησης. Δεν στέλνονται στο Shannon και δεν ακολουθούν σε άλλη συσκευή.
Κλειδί API	Στη μνήμη της ανοιχτής καρτέλας. Ένα κλειδί που επικολλήθηκε χάνεται όταν η σελίδα φορτώσει ξανά ή κλείσει η καρτέλα. Όταν έχετε συνδεθεί, το κλειδί διαβάζεται από τον λογαριασμό σας κάθε φορά.
Συμβάντα stream, κεφαλίδες και αίτημα του τελευταίου γύρου	Στην ανοιχτή σελίδα, μέχρι να φορτώσει ξανά.
Αιτήματα	Στέλνονται από το πρόγραμμα περιήγησής σας στο API με το κλειδί σας. Προσμετρώνται στο υπόλοιπό σας όπως κάθε άλλο αίτημα API.

Πληκτρολόγιο

Πλήκτρα	Τι κάνει
`Enter`	Αποστολή του μηνύματος.
`Shift` + `Enter`	Έναρξη νέας γραμμής.
`Ctrl` + `K`	Άνοιγμα του πίνακα εντολών: αλλαγή endpoint ή μοντέλου, ορισμός προτύπου system, έναρξη νέας συνομιλίας, εναλλαγή streaming, εργαλείων ή σύγκρισης. Σε Mac: ⌘ K.
`Esc`	Διακοπή της απάντησης που γράφεται, ή κλείσιμο ανοιχτού πάνελ σε στενή οθόνη.