API Playground

ინტერაქტიული

სცადეთ ყველა მოდელი და endpoint ბრაუზერში თქვენი გასაღებით — სტრიმინგული გამოტანა, მოთხოვნის ინსპექტორი და გენერირებული კოდი, რომლის პირდაპირ ჩასმაც შეგიძლიათ თქვენს აპლიკაციაში.

გახსენით Playground

playground არის API-ის ჩატ-კონსოლი მისამართზე /docs/playground. თქვენ მოდელს ესაუბრებით, playground კი აგზავნის იმავე მოთხოვნებს, რასაც თქვენი კოდი გააგზავნიდა: სამიდან ერთ endpoint-ზე, თქვენ მიერ არჩეული მოდელით, სისტემური პრომპტით, პარამეტრებითა და ინსტრუმენტებით. ყოველი მოთხოვნის წაკითხვა შეიძლება როგორც კოდად, ისე ნედლი stream-ის მოვლენებად.

დაწყება

მიეცით გასაღები — შესული ხართ თუ არა, playground იყენებს თქვენი ანგარიშის API გასაღებს და აჩვენებს თქვენს ბალანსს. თუ არ ხართ შესული, აირჩიეთ Add key და ჩასვით გასაღები: ის ინახება მხოლოდ ამ ჩანართში და არასოდეს ინახება მუდმივად.
აირჩიეთ endpoint და მოდელი — ზედა ზოლში არის endpoint-ის გადამრთველი და მოდელის ამომრჩევი. ახალი საუბარი იწყება Chat Completions-ზე მოდელით shannon-3.
გააგზავნეთ შეტყობინება — ქვემოთ ჩაწერეთ ტექსტი და დააჭირეთ Enter-ს. ყოველი პასუხი საუბარს ემატება, ამიტომ შემდეგი შეტყობინება მას აგრძელებს. ცარიელი ეკრანი სამ საწყის პრომპტს და მზა ინსტრუმენტის გამოძახების მაგალითს გთავაზობთ.

თქვენს გასაღებს გვერდზე Keys & usage იპოვით და შეცვლით. გასაღებები და გამოყენება

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 ტოკენზე, კონტექსტის ფანჯარა და ნიშნები ინსტრუმენტების, სურათის შეყვანის, მსჯელობისა და სტრუქტურირებული შედეგის შესახებ.

საუბარი

პასუხები საუბარში იწერება სტრიმით, ისევე, როგორც იქმნება. მოდელის მსჯელობა ცალკე ბლოკშია ნაჩვენები, რომლის ჩაკეცვაც შეგიძლიათ.
ყოველი პასუხის ქვეშ: დრო პირველ ტოკენამდე, ტოკენები წამში, გასული დრო, შემავალი და გამომავალი ტოკენები ქეშირებული და მსჯელობის ნაწილებით, ბიჯის ღირებულების შეფასება, დასრულების მიზეზი და პასუხის id.
თქვენი შეტყობინების რედაქტირება და იმ წერტილიდან ხელახლა გაგზავნა შეიძლება. პასუხის ხელახლა გენერაცია შეიძლება. შეტყობინების წაშლა შეიძლება და წაშლის გაუქმება რამდენიმე წამის განმავლობაში არის შესაძლებელი.
Stop ან Esc კლავიში წერის პროცესში მყოფ პასუხს წყვეტს.
სურათები მიმაგრდება სურათის ღილაკით, ჩასმით ან ფაილის გადმოთრევით, იმ მოდელებისთვის, რომლებიც სურათებს იღებენ. სურათი გაგზავნამდე მცირდება ისე, რომ გრძელი მხარე 1,568 პიქსელი იყოს. 30 MB-ზე დიდი ფაილი გამოიტოვება.
შეტყობინების ველი და სისტემური პრომპტი ტოკენების რაოდენობას აჩვენებს. hosted open-weight მოდელებისთვის ეს არის ზუსტი რაოდენობა POST /v1/tokenize-დან. სხვა მოდელებისთვის ეს შეფასებაა და აღინიშნება ნიშნით ≈.
წარუმატებელი მოთხოვნა გვიჩვენებს, რა უნდა გააკეთოთ შემდეგ: დააყენეთ გასაღები, თუ ის უარყოფილია; შეავსეთ ბალანსი, თუ ის ამოიწურა; დაელოდეთ მითითებულ წამებს, თუ მოთხოვნები ზედმეტად ბევრი იყო; ან სცადეთ ხელახლა სერვერის შეცდომის შემდეგ.

მოთხოვნის პარამეტრები

ღილაკი Settings ხსნის პანელს ექვსი ჩანართით. პარამეტრები საუბარს ეკუთვნის: ყოველ საუბარს თავისი აქვს.

ჩანართი	რას შეიცავს
სისტემური	საუბრის სისტემური პრომპტი, რომელიც ყოველ მოთხოვნას ეგზავნება. მას ავსებს ხუთი შაბლონი და ნაჩვენებია მისი ტოკენების რაოდენობა.
პარამეტრები	გამოტანის მაქსიმალური ტოკენები, ტემპერატურა, `top_p`, მსჯელობის დონე, შეჩერების თანმიმდევრობები, `seed` და გადამრთველები სტრიმინგისა და ვებძიებისთვის. კონტროლი, რომლისთვისაც არჩეულ endpoint-ს ველი არ აქვს, გამორთულია და აღნიშნულია.
ინსტრუმენტები	მოთხოვნასთან ერთად გაგზავნილი ინსტრუმენტების განსაზღვრებები: ოთხი წინასწარ მომზადებული ვარიანტი (`get_weather`, `read_file`, `run_shell`, `web_search`) ან თქვენი საკუთარი განსაზღვრება JSON-ის სახით, და `tool_choice` (`auto`, `none`, `required` ან ერთი ინსტრუმენტი სახელით). როცა მოდელი ინსტრუმენტს იძახებს, საუბარში გამოძახება ჩანს შედეგის ველით. როცა Offer sample results ჩართულია, ერთი დაწკაპუნებით შედეგის ნიმუში ივსება. შეგიძლიათ საკუთარიც ჩაწეროთ და გააგზავნოთ, რომ ბიჯი გაგრძელდეს.
სტრუქტურირებული	`response_format`: `text`, `json_object` ან `json_schema` სქემის სახელითა და JSON სქემით. სქემის დაყენებისას ბოლო პასუხი მის წინააღმდეგ მოწმდება და საუბარში აღინიშნება, შეესაბამება თუ არა. ჩანართი Messages endpoint-ზე გამორთულია, ხოლო ვარიანტი, რომელსაც არჩეული მოდელი არ იღებს, არ შემოგთავაზდებათ.
კოდი	მიმდინარე საუბრის მოთხოვნა cURL, Python, Node ან Go კოდის სახით, აგებული საუბრისა და მისი პარამეტრებისგან. გასაღები იბეჭდება როგორც `YOUR_API_KEY`. კოდის კოპირება ან დიდ ხედში გახსნა შეიძლება.
მოვლენები	ბოლო ბიჯი ისე, როგორც ის ქსელში გავიდა: ყოველი stream-ის მოვლენა დროის წანაცვლებით და ფილტრით, აწყობილი პასუხი, პასუხის სათაურები (`x-request-id`, `content-type`, `retry-after`, `date`) და მოთხოვნის სხეული. ეს ინახება გვერდის ხელახლა ჩატვირთვამდე.

შეყვანის შემოწმება

თქვენ მიერ შეყვანილი მნიშვნელობები მოთხოვნის გაგზავნამდე მოწმდება. დიაპაზონს გარეთ მყოფი მნიშვნელობა თავის ველთან აღინიშნება და გაგზავნა შეჩერდება, სანამ ის არ გასწორდება.

პარამეტრი	შემოწმება
გამოტანის მაქსიმალური ტოკენები	მთელი რიცხვი 1-დან მოდელის `max_output_tokens`-მდე.
ტემპერატურა	რიცხვი 0-დან 2-მდე. ცარიელი ველი მოთხოვნიდან გამოიტოვება.
`top_p`	რიცხვი 0-დან 1-მდე. ცარიელი ველი მოთხოვნიდან გამოიტოვება.
`seed`	მთელი რიცხვი.
შეჩერების თანმიმდევრობები	მაქსიმუმ 4, მძიმეებით გამოყოფილი.
`response_format`	უნდა იყოს ისეთი, რომელსაც არჩეული მოდელი იღებს. საუბარი, რომელიც გადატანილია მოდელზე `json_schema`-ს ან `response_format`-ის გარეშე, შეჩერდება და მიზეზი მიეთითება.
სურათები	ამოიშლება შეტყობინებიდან, როცა გადახვალთ მოდელზე, რომელიც მხოლოდ ტექსტს იღებს; ამის შესახებ შენიშვნა გამოჩნდება.

ორი მოდელის შედარება

Compare two models მენიუში More ამატებს მეორე მოდელის არჩევანს. ამის შემდეგ ყოველი შეტყობინება ორივე მოდელს ერთდროულად და ერთი და იმავე პარამეტრებით ეგზავნება, ხოლო ორი პასუხი გვერდიგვერდ გამოჩნდება და აღინიშნება A-თი და B-თი. ერთ მხარეს ცალკე შეგიძლიათ ხელახლა გენერაცია. როცა ერთი მხარე ინსტრუმენტს იძახებს, თქვენ მიერ გაგზავნილი შედეგი მხოლოდ ამ მხარეს აგრძელებს.

Copy share link საუბარს თვით ბმულში ათავსებს, #-ის შემდგომ ნაწილში. არაფერი იტვირთება. სურათები, თქვენი გასაღები და ბოლო გაშვების დეტალები არ შედის. ვინც ბმულს გახსნის, საუბარს თავის playground-ში ახალი საუბრის სახით მიიღებს.
ბმულისთვის ზედმეტად გრძელი საუბარი შენიშვნით უარყოფილია. ამის ნაცვლად ჩამოტვირთეთ ის JSON-ად.
Download conversation JSON საუბარს პარამეტრებითურთ ფაილად ინახავს. Import JSON საუბრების პანელში ასეთ ფაილს ხსნის.
Copy as cURL ამჟამინდელ მოთხოვნას ერთ cURL ბრძანებად აკოპირებს.

რა სად ინახება

რა	სად ინახება
საუბრები, შენახული ინსტრუმენტები, ბოლო მოდელები, პანელის განლაგება	ამ ბრაუზერში. ისინი Shannon-ს არ ეგზავნება და სხვა მოწყობილობაზე თქვენთან ერთად არ გადადის.
API გასაღები	გახსნილი ჩანართის მეხსიერებაში. ჩასმული გასაღები გვერდის ხელახლა ჩატვირთვისას ან ჩანართის დახურვისას იკარგება. თუ შესული ხართ, გასაღები ყოველ ჯერზე თქვენი ანგარიშიდან იკითხება.
ბოლო ბიჯის stream-ის მოვლენები, სათაურები და მოთხოვნა	გახსნილ გვერდზე, გვერდის ხელახლა ჩატვირთვამდე.
მოთხოვნები	ეგზავნება თქვენი ბრაუზერიდან API-ს თქვენი გასაღებით. ისინი თქვენს ბალანსზე ითვლება ისევე, როგორც ნებისმიერი სხვა API მოთხოვნა.

კლავიატურა

კლავიშები	რას აკეთებს
`Enter`	შეტყობინების გაგზავნა.
`Shift` + `Enter`	ახალი ხაზის დაწყება.
`Ctrl` + `K`	ბრძანებების პალიტრის გახსნა: endpoint-ის ან მოდელის გადართვა, სისტემური შაბლონის არჩევა, ახალი საუბრის დაწყება, სტრიმინგის, ინსტრუმენტების ან შედარების ჩართვა/გამორთვა. Mac-ზე: ⌘ K.
`Esc`	წერის პროცესში მყოფი პასუხის შეჩერება ან ვიწრო ეკრანზე გახსნილი პანელის დახურვა.