API Playground
អន្តរកម្មសាកល្បងគ្រប់ម៉ូដែល និង endpoint ក្នុង browser ដោយ key របស់អ្នក — output ជា streaming, request inspector និងកូដដែលបានបង្កើត ដែលអ្នកអាចបិទភ្ជាប់ចូលកម្មវិធីរបស់អ្នកបានភ្លាម។
playground គឺជា chat console សម្រាប់ API នៅ /docs/playground។ អ្នកនិយាយជាមួយម៉ូដែល ហើយ playground ផ្ញើ request ដូចគ្នានឹងកូដរបស់អ្នកនឹងផ្ញើ៖ ទៅ endpoint មួយក្នុងចំណោមបី ជាមួយម៉ូដែល system prompt ប៉ារ៉ាម៉ែត្រ និង tool ដែលអ្នកកំណត់។ រាល់ request អាចអានបានវិញជាកូដ និងជា raw stream event។
ចាប់ផ្តើម
- ផ្តល់ key ឱ្យវា — ពេលចូលគណនី playground ប្រើ API key នៃគណនីរបស់អ្នក ហើយបង្ហាញសមតុល្យរបស់អ្នក។ ពេលមិនទាន់ចូលគណនី សូមជ្រើស Add key ហើយបិទភ្ជាប់ key៖ វាត្រូវបានរក្សាទុកក្នុង tab នេះប៉ុណ្ណោះ ហើយមិនដែលត្រូវបានរក្សាទុកជាអចិន្ត្រៃយ៍ទេ។
- ជ្រើស endpoint និងម៉ូដែល — របារខាងលើមានកុងតាក់ endpoint និង model picker។ ការសន្ទនាថ្មីចាប់ផ្តើមលើ Chat Completions ជាមួយ
shannon-3។ - ផ្ញើសារ — វាយខាងក្រោម ហើយចុច Enter។ រាល់ចម្លើយចូលរួមក្នុងការសន្ទនា ដូច្នេះសារបន្ទាប់បន្តវា។ អេក្រង់ទទេផ្តល់ starter prompt បី និងឧទាហរណ៍ការហៅ tool ដែលរួចរាល់។
អ្នករក និងប្តូរ key របស់អ្នកនៅលើទំព័រ Keys & usage។ Keys & usage
Endpoint និងម៉ូដែល
កុងតាក់ endpoint សម្រេចថា playground សាងសង់ទ្រង់ទ្រាយ request ណា។ អ្នកអាចប្តូរវាកណ្តាលការសន្ទនា៖ សារនៅដដែល។
| Endpoint | Request ដែលវាផ្ញើ | ឯកសារយោង |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | ទ្រង់ទ្រាយ Anthropic |
model picker រាយអ្វីដែល GET /v1/models ត្រឡប់។ វាអាចស្វែងរកបាន រក្សាម៉ូដែលថ្មីៗរបស់អ្នកនៅខាងលើ ហើយបង្ហាញសម្រាប់ម៉ូដែលនីមួយៗនូវតម្លៃក្នុង 1M token, context window និងសញ្ញាសម្គាល់សម្រាប់ tool, input រូបភាព, reasoning និង output មានរចនាសម្ព័ន្ធ។
ការសន្ទនា
- ចម្លើយ stream ចូលក្នុង thread នៅពេលវាត្រូវបានសរសេរ។ reasoning របស់ម៉ូដែលត្រូវបានបង្ហាញក្នុង block ផ្ទាល់ខ្លួនដែលអ្នកអាចបត់បាន។
- ក្រោមរាល់ចម្លើយ៖ ពេលវាដល់ token ដំបូង token ក្នុងមួយវិនាទី រយៈពេលដែលបានកន្លងផុត input និង output token ជាមួយផ្នែក cached និង reasoning ការប៉ាន់ស្មានតម្លៃនៃវេន finish reason និង response id។
- សាររបស់អ្នកអាចកែ ហើយផ្ញើម្តងទៀតពីចំណុចនោះ។ ចម្លើយអាចបង្កើតឡើងវិញ។ សារអាចលុប ហើយការលុបអាចមិនធ្វើវិញក្នុងរយៈពេលពីរបីវិនាទី។
- Stop ឬគ្រាប់ចុច Esc បញ្ចប់ចម្លើយដែលកំពុងត្រូវបានសរសេរ។
- រូបភាពត្រូវបានភ្ជាប់ដោយប៊ូតុងរូបភាព ដោយការបិទភ្ជាប់ ឬដោយការទម្លាក់ឯកសារ សម្រាប់ម៉ូដែលដែលទទួលរូបភាព។ រូបភាពត្រូវបានបង្រួមទៅ 1,568 pixel លើគែមវែងរបស់វាមុនពេលផ្ញើ។ ឯកសារលើស 30 MB ត្រូវបានរំលង។
- composer និង system prompt បង្ហាញចំនួន token។ សម្រាប់ម៉ូដែល open-weight ដែលបង្ហោះ វាជាចំនួនពិតប្រាកដពី
POST /v1/tokenize។ សម្រាប់ម៉ូដែលផ្សេងទៀត វាជាការប៉ាន់ស្មាន ដែលសម្គាល់ដោយ≈។ - request ដែលបរាជ័យបង្ហាញអ្វីដែលត្រូវធ្វើបន្ទាប់៖ កំណត់ key នៅពេល key ត្រូវបានបដិសេធ បញ្ចូលឥណទាននៅពេលសមតុល្យអស់ ចំនួនវិនាទីដែលត្រូវរង់ចាំបន្ទាប់ពី request ច្រើនពេក ឬព្យាយាមម្តងទៀតបន្ទាប់ពី server error។
ការកំណត់ request
ប៊ូតុង Settings បើកផ្ទាំងមួយដែលមានប្រាំមួយ tab។ ការកំណត់ជារបស់ការសន្ទនា៖ រាល់ការសន្ទនារក្សាការកំណត់ផ្ទាល់ខ្លួន។
| ផ្ទាំង | អ្វីដែលវាមាន |
|---|---|
| System | system prompt នៃការសន្ទនា ដែលផ្ញើជាមួយរាល់ request។ template ប្រាំបំពេញវា ហើយចំនួន token របស់វាត្រូវបានបង្ហាញ។ |
| ប៉ារ៉ាម៉ែត្រ | Max output tokens, temperature, top_p, reasoning effort, stop sequence, seed និងកុងតាក់សម្រាប់ streaming និងការស្វែងរកវេប។ ការគ្រប់គ្រងដែល endpoint ដែលបានជ្រើសគ្មាន field សម្រាប់ត្រូវបានបិទ និងសម្គាល់។ |
| Tool | និយមន័យ tool ដែលផ្ញើជាមួយ request៖ preset បួន (get_weather, read_file, run_shell, web_search) ឬនិយមន័យផ្ទាល់ខ្លួនរបស់អ្នកជា JSON និង tool_choice (auto, none, required ឬ tool មួយតាមឈ្មោះ)។ នៅពេលម៉ូដែលហៅ tool thread បង្ហាញការហៅជាមួយប្រអប់សម្រាប់លទ្ធផល។ ពេល Offer sample results បើក ការចុចមួយដងបំពេញលទ្ធផលគំរូ។ អ្នកក៏អាចវាយលទ្ធផលផ្ទាល់ខ្លួន ហើយផ្ញើវាដើម្បីបន្តវេន។ |
| មានរចនាសម្ព័ន្ធ | response_format៖ text, json_object ឬ json_schema ជាមួយឈ្មោះ schema និង JSON schema។ ពេលកំណត់ schema ចម្លើយចុងក្រោយត្រូវបានពិនិត្យនឹងវា ហើយសម្គាល់ក្នុង thread ថាត្រូវគ្នា ឬមិនត្រូវគ្នា។ tab នេះត្រូវបានបិទលើ endpoint Messages ហើយជម្រើសដែលម៉ូដែលដែលបានជ្រើសមិនទទួលមិនត្រូវបានផ្តល់ឱ្យទេ។ |
| កូដ | request នៃការសន្ទនាបច្ចុប្បន្នជាកូដ cURL, Python, Node ឬ Go ដែលបង្កើតពីការសន្ទនា និងការកំណត់របស់វា។ key ត្រូវបានបោះពុម្ពជា YOUR_API_KEY។ កូដអាចចម្លងបាន ឬបើកក្នុងទិដ្ឋភាពធំ។ |
| Event | វេនចុងក្រោយដូចដែលវាឆ្លងកាត់បណ្តាញ៖ រាល់ stream event ជាមួយ time offset និងតម្រង ចម្លើយដែលបានផ្គុំ header ចម្លើយ (x-request-id, content-type, retry-after, date) និងខ្លឹមសារ request។ ទាំងនេះត្រូវបានរក្សារហូតដល់ទំព័រ reload។ |
ការពិនិត្យ input
តម្លៃដែលអ្នកវាយត្រូវបានពិនិត្យមុនពេល request ត្រូវបានផ្ញើ។ តម្លៃក្រៅដែនត្រូវបានសម្គាល់នៅ field របស់វា ហើយការផ្ញើត្រូវបានរារាំងរហូតដល់វាត្រូវបានកែ។
| ការកំណត់ | ការពិនិត្យ |
|---|---|
| Max output tokens | ចំនួនគត់ពី 1 ដល់ max_output_tokens របស់ម៉ូដែល។ |
| Temperature | លេខពី 0 ដល់ 2។ ទទេមានន័យថាទុក field ចេញពី request។ |
top_p | លេខពី 0 ដល់ 1។ ទទេមានន័យថាទុក field ចេញពី request។ |
seed | ចំនួនគត់។ |
| Stop sequence | ច្រើនបំផុត 4 បំបែកដោយសញ្ញាក្បៀស។ |
response_format | ត្រូវតែជាមួយដែលម៉ូដែលដែលបានជ្រើសទទួល។ ការសន្ទនាដែលបានប្តូរទៅម៉ូដែលគ្មាន json_schema ឬគ្មាន response_format ត្រូវបានរារាំងជាមួយមូលហេតុ។ |
| រូបភាព | ត្រូវបានដកចេញពីសារ នៅពេលអ្នកប្តូរទៅម៉ូដែលដែលទទួលតែអត្ថបទ ជាមួយកំណត់សម្គាល់។ |
ប្រៀបធៀបម៉ូដែលពីរ
ប្រៀបធៀបម៉ូដែលពីរ ក្នុងម៉ឺនុយ More បន្ថែម model picker ទីពីរ។ បន្ទាប់មករាល់សារទៅដល់ម៉ូដែលទាំងពីរក្នុងពេលតែមួយ ជាមួយការកំណត់ដូចគ្នា ហើយចម្លើយទាំងពីរស្ថិតនៅក្បែរគ្នា ដោយសម្គាល់ A និង B។ អ្នកអាចបង្កើតម្ខាងឡើងវិញតែឯង។ នៅពេលម្ខាងហៅ tool លទ្ធផលដែលអ្នកផ្ញើបន្តតែម្ខាងនោះប៉ុណ្ណោះ។
ចែករំលែក នាំចេញ និងនាំចូល
- Copy share link ខ្ចប់ការសន្ទនាចូលក្នុងតំណភ្ជាប់ផ្ទាល់ នៅក្នុងផ្នែកក្រោយ
#។ គ្មានអ្វីត្រូវបាន upload ទេ។ រូបភាព key របស់អ្នក និងព័ត៌មានលម្អិតនៃការដំណើរការចុងក្រោយត្រូវបានទុកចោល។ អ្នកដែលបើកតំណភ្ជាប់ទទួលបានការសន្ទនាជាការសន្ទនាថ្មីក្នុង playground របស់ខ្លួន។ - ការសន្ទនាដែលវែងពេកសម្រាប់តំណភ្ជាប់ត្រូវបានបដិសេធជាមួយកំណត់សម្គាល់។ សូមទាញយកវាជា JSON ជំនួសវិញ។
- Download conversation JSON រក្សាទុកការសន្ទនាជាមួយការកំណត់របស់វាជាឯកសារ។ Import JSON នៅក្នុងផ្ទាំងការសន្ទនាបើកឯកសារបែបនេះ។
- Copy as cURL ចម្លង request បច្ចុប្បន្នជាពាក្យបញ្ជា cURL មួយ។
អ្វីត្រូវបានរក្សាទុកនៅឯណា
| អ្វី | កន្លែងរក្សាទុក |
|---|---|
| ការសន្ទនា tool ដែលបានរក្សាទុក ម៉ូដែលថ្មីៗ ទម្រង់ផ្ទាំង | នៅក្នុង browser នេះ។ ពួកវាមិនត្រូវបានផ្ញើទៅ Shannon ហើយមិនតាមអ្នកទៅឧបករណ៍ផ្សេងទេ។ |
| API key | នៅក្នុងអង្គចងចាំនៃ tab ដែលបើក។ key ដែលបានបិទភ្ជាប់បាត់នៅពេលទំព័រ reload ឬ tab បិទ។ ពេលចូលគណនី key ត្រូវបានអានពីគណនីរបស់អ្នកគ្រប់ពេល។ |
| event នៃ stream, header និងសំណើនៃវេនចុងក្រោយ | នៅក្នុងទំព័រដែលបើក រហូតដល់វា reload។ |
| Request | ផ្ញើពី browser របស់អ្នកទៅ API ជាមួយ key របស់អ្នក។ ពួកវាត្រូវបានរាប់ចូលសមតុល្យរបស់អ្នក ដូចរាល់ API request ផ្សេងទៀត។ |
ក្តារចុច
| គ្រាប់ចុច | អ្វីដែលវាធ្វើ |
|---|---|
Enter | ផ្ញើសារ។ |
Shift + Enter | ចាប់ផ្តើមបន្ទាត់ថ្មី។ |
Ctrl + K | បើក command palette៖ ប្តូរ endpoint ឬម៉ូដែល កំណត់ system template ចាប់ផ្តើមការសន្ទនាថ្មី បិទ/បើក streaming, tool ឬការប្រៀបធៀប។ លើ Mac៖ ⌘ K។ |
Esc | បញ្ឈប់ចម្លើយដែលកំពុងត្រូវបានសរសេរ ឬបិទផ្ទាំងដែលបើកនៅលើអេក្រង់តូច។ |