API Playground
ໂຕ້ຕອບລອງທຸກ model ແລະ endpoint ໃນ browser ດ້ວຍ key ຂອງທ່ານເອງ — output ແບບ streaming, ຕົວກວດ request ແລະ ໂຄ້ດທີ່ສ້າງໃຫ້ ທີ່ທ່ານວາງໃສ່ແອັບໄດ້ທັນທີ.
playground ແມ່ນຄອນໂຊນ chat ສຳລັບ API ທີ່ /docs/playground. ທ່ານສົນທະນາກັບ model, ແລະ playground ສົ່ງຄຳຮ້ອງຂໍຄືກັນກັບທີ່ໂຄ້ດຂອງທ່ານຈະສົ່ງ: ໄປຫາໜຶ່ງໃນສາມ endpoint, ດ້ວຍ model, system prompt, parameters ແລະ tools ທີ່ທ່ານຕັ້ງ. ທຸກຄຳຮ້ອງຂໍສາມາດອ່ານຄືນເປັນໂຄ້ດ ແລະ ເປັນ stream event ດິບ.
ເລີ່ມຕົ້ນ
- ໃຫ້ key — ເມື່ອເຂົ້າສູ່ລະບົບແລ້ວ, playground ໃຊ້ API key ຂອງບັນຊີທ່ານ ແລະ ສະແດງຍອດເງິນຂອງທ່ານ. ຖ້າບໍ່ໄດ້ເຂົ້າສູ່ລະບົບ, ເລືອກ Add key ແລະ ວາງ key: ມັນຖືກເກັບໄວ້ໃນແຖບນີ້ເທົ່ານັ້ນ ແລະ ບໍ່ເຄີຍຖືກບັນທຶກ.
- ເລືອກ endpoint ແລະ model — ແຖບດ້ານເທິງມີສະວິດ endpoint ແລະ model picker. ການສົນທະນາໃໝ່ເລີ່ມໃນ Chat Completions ກັບ
shannon-3. - ສົ່ງຂໍ້ຄວາມ — ພິມຂ້າງລຸ່ມ ແລະ ກົດ Enter. ທຸກຄຳຕອບເຂົ້າຮ່ວມການສົນທະນາ, ດັ່ງນັ້ນຂໍ້ຄວາມຖັດໄປສືບຕໍ່ຈາກມັນ. ໜ້າຈໍວ່າງມີ prompt ເລີ່ມຕົ້ນສາມອັນ ແລະ ຕົວຢ່າງການເອີ້ນ tool ທີ່ພ້ອມໃຊ້.
ທ່ານຊອກຫາ ແລະ ປ່ຽນ key ໄດ້ໃນໜ້າ Keys & usage. Keys & usage
Endpoint ແລະ model
ສະວິດ endpoint ຕັດສິນວ່າ playground ສ້າງຄຳຮ້ອງຂໍໃນຮູບແບບໃດ. ທ່ານປ່ຽນໄດ້ກາງການສົນທະນາ; ຂໍ້ຄວາມຍັງຢູ່.
| Endpoint | ຄຳຮ້ອງຂໍທີ່ມັນສົ່ງ | ເອກະສານອ້າງອີງ |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic |
model picker ລາຍຊື່ສິ່ງທີ່ GET /v1/models ສົ່ງກັບ. ຄົ້ນຫາໄດ້, ເກັບ model ຫຼ້າສຸດຂອງທ່ານໄວ້ເທິງສຸດ, ແລະ ສະແດງສຳລັບແຕ່ລະ model ລາຄາຕໍ່ 1M tokens, context window ແລະ ເຄື່ອງໝາຍສຳລັບ tools, input ຮູບພາບ, reasoning ແລະ structured output.
ການສົນທະນາ
- ຄຳຕອບ stream ເຂົ້າ thread ໃນຂະນະທີ່ຖືກຂຽນ. reasoning ຂອງ model ຖືກສະແດງໃນ block ແຍກຕ່າງຫາກທີ່ທ່ານພັບໄດ້.
- ໃຕ້ແຕ່ລະຄຳຕອບ: ເວລາຮອດ token ທຳອິດ, tokens ຕໍ່ວິນາທີ, ເວລາທີ່ໃຊ້, input ແລະ output tokens ພ້ອມສ່ວນ cached ແລະ reasoning, ການຄາດຄະເນຄ່າໃຊ້ຈ່າຍຂອງຮອບ, ເຫດຜົນທີ່ຈົບ ແລະ response id.
- ຂໍ້ຄວາມຂອງທ່ານສາມາດແກ້ໄຂ ແລະ ສົ່ງອີກຈາກຈຸດນັ້ນ. ຄຳຕອບສາມາດສ້າງຄືນໃໝ່. ຂໍ້ຄວາມສາມາດລຶບໄດ້, ແລະ ການລຶບສາມາດຍົກເລີກໄດ້ພາຍໃນສອງສາມວິນາທີ.
- Stop ຫຼືປຸ່ມ Esc ຢຸດຄຳຕອບທີ່ກຳລັງຖືກຂຽນ.
- ແນບຮູບພາບດ້ວຍປຸ່ມຮູບພາບ, ດ້ວຍການວາງ ຫຼື ດ້ວຍການລາກໄຟລ໌ມາວາງ, ສຳລັບ model ທີ່ຮັບຮູບພາບ. ຮູບພາບຖືກຍ່ອ/ຂະຫຍາຍເປັນ 1,568 ພິກເຊວທີ່ດ້ານຍາວກ່ອນສົ່ງ. ໄຟລ໌ທີ່ເກີນ 30 MB ຖືກຂ້າມ.
- composer ແລະ system prompt ສະແດງຈຳນວນ tokens. ສຳລັບ hosted open-weight models ມັນແມ່ນຈຳນວນທີ່ຖືກຕ້ອງຈາກ
POST /v1/tokenize. ສຳລັບ model ອື່ນມັນເປັນການຄາດຄະເນ, ໝາຍດ້ວຍ≈. - ຄຳຮ້ອງຂໍທີ່ລົ້ມເຫຼວສະແດງສິ່ງທີ່ຕ້ອງເຮັດຕໍ່: ຕັ້ງ key ເມື່ອ key ຖືກປະຕິເສດ, ເຕີມເງິນເມື່ອຍອດເງິນໝົດ, ຈຳນວນວິນາທີທີ່ຕ້ອງລໍຖ້າຫຼັງມີຄຳຮ້ອງຂໍຫຼາຍເກີນໄປ, ຫຼື ລອງໃໝ່ຫຼັງຂໍ້ຜິດພາດຂອງ server.
ການຕັ້ງຄ່າຄຳຮ້ອງຂໍ
ປຸ່ມ Settings ເປີດ panel ທີ່ມີຫົກແຖບ. ການຕັ້ງຄ່າເປັນຂອງການສົນທະນາ: ແຕ່ລະການສົນທະນາເກັບຂອງຕົນເອງ.
| ແຖບ | ສິ່ງທີ່ມັນເກັບ |
|---|---|
| System | system prompt ຂອງການສົນທະນາ, ສົ່ງກັບທຸກຄຳຮ້ອງຂໍ. ມີ template ຫ້າອັນເຕີມມັນໃຫ້, ແລະ ສະແດງຈຳນວນ tokens ຂອງມັນ. |
| Parameters | Max output tokens, temperature, top_p, reasoning effort, stop sequence, seed, ແລະ ສະວິດສຳລັບ streaming ແລະ ການຄົ້ນຫາເວັບ. ຕົວຄວບຄຸມທີ່ endpoint ທີ່ເລືອກບໍ່ມີຟີລດ໌ຮອງຮັບຈະຖືກປິດ ແລະ ໝາຍໄວ້. |
| Tools | ຄຳນິຍາມ tool ທີ່ສົ່ງກັບຄຳຮ້ອງຂໍ: preset ສີ່ອັນ (get_weather, read_file, run_shell, web_search) ຫຼື ຄຳນິຍາມຂອງທ່ານເອງເປັນ JSON, ແລະ tool_choice (auto, none, required ຫຼື ໜຶ່ງ tool ຕາມຊື່). ເມື່ອ model ເອີ້ນ tool, thread ສະແດງການເອີ້ນພ້ອມຊ່ອງສຳລັບຜົນລັບ. ເມື່ອເປີດ Offer sample results, ຄລິກດຽວເຕີມຜົນລັບຕົວຢ່າງ. ທ່ານພິມຂອງທ່ານເອງກໍໄດ້, ແລ້ວສົ່ງເພື່ອສືບຕໍ່ຮອບນັ້ນ. |
| Structured | response_format: text, json_object ຫຼື json_schema ພ້ອມຊື່ schema ແລະ JSON schema. ເມື່ອຕັ້ງ schema, ຄຳຕອບສຸດທ້າຍຖືກກວດກັບມັນ ແລະ ໝາຍໃນ thread ວ່າກົງກັນຫຼືບໍ່. ແຖບນີ້ຖືກປິດໃນ endpoint Messages, ແລະ ຕົວເລືອກທີ່ model ທີ່ເລືອກບໍ່ຮັບຈະບໍ່ຖືກສະເໜີ. |
| ໂຄ້ດ | ຄຳຮ້ອງຂໍຂອງການສົນທະນາປັດຈຸບັນເປັນໂຄ້ດ cURL, Python, Node ຫຼື Go, ສ້າງຈາກການສົນທະນາ ແລະ ການຕັ້ງຄ່າຂອງມັນ. key ຖືກພິມເປັນ YOUR_API_KEY. ໂຄ້ດສາມາດຄັດລອກ ຫຼື ເປີດໃນມຸມມອງໃຫຍ່. |
| Events | ຮອບສຸດທ້າຍຕາມທີ່ມັນຜ່ານສາຍ: ທຸກ stream event ພ້ອມເວລາ offset ແລະ ຕົວກອງ, ຄຳຕອບທີ່ປະກອບແລ້ວ, header ຂອງຄຳຕອບ (x-request-id, content-type, retry-after, date) ແລະ body ຂອງຄຳຮ້ອງຂໍ. ສິ່ງເຫຼົ່ານີ້ຖືກເກັບຈົນກວ່າຈະໂຫຼດໜ້າໃໝ່. |
ການກວດ input
ຄ່າທີ່ທ່ານພິມຈະຖືກກວດກ່ອນສົ່ງຄຳຮ້ອງຂໍ. ຄ່າທີ່ຢູ່ນອກຊ່ວງຈະຖືກໝາຍທີ່ຟີລດ໌ຂອງມັນ, ແລະ ການສົ່ງຈະຖືກຖ່ວງໄວ້ຈົນກວ່າຈະແກ້ໄຂ.
| ການຕັ້ງຄ່າ | ການກວດ |
|---|---|
| Max output tokens | ຈຳນວນເຕັມຕັ້ງແຕ່ 1 ຫາ max_output_tokens ຂອງ model. |
| Temperature | ຕົວເລກຕັ້ງແຕ່ 0 ຫາ 2. ຖ້າວ່າງ ຈະບໍ່ໃສ່ຟີລດ໌ນີ້ໃນຄຳຮ້ອງຂໍ. |
top_p | ຕົວເລກຕັ້ງແຕ່ 0 ຫາ 1. ຖ້າວ່າງ ຈະບໍ່ໃສ່ຟີລດ໌ນີ້ໃນຄຳຮ້ອງຂໍ. |
seed | ຈຳນວນເຕັມ. |
| Stop sequence | ສູງສຸດ 4, ແຍກດ້ວຍເຄື່ອງໝາຍຈຸດ. |
response_format | ຕ້ອງເປັນອັນທີ່ model ທີ່ເລືອກຮັບ. ການສົນທະນາທີ່ຍ້າຍໄປຫາ model ທີ່ບໍ່ມີ json_schema ຫຼື ບໍ່ມີ response_format ຈະຖືກຖ່ວງໄວ້ພ້ອມເຫດຜົນ. |
| ຮູບພາບ | ຖືກລຶບອອກຈາກຂໍ້ຄວາມເມື່ອທ່ານປ່ຽນໄປ model ທີ່ຮັບສະເພາະຂໍ້ຄວາມ, ພ້ອມໝາຍເຫດ. |
ປຽບທຽບສອງ model
Compare two models ໃນເມນູ More ເພີ່ມ model picker ອັນທີສອງ. ຈາກນັ້ນແຕ່ລະຂໍ້ຄວາມຈະຖືກສົ່ງໄປຫາທັງສອງ model ພ້ອມກັນ, ດ້ວຍການຕັ້ງຄ່າດຽວກັນ, ແລະ ສອງຄຳຕອບຢູ່ຄຽງຂ້າງກັນ, ໝາຍ A ແລະ B. ທ່ານສ້າງໃໝ່ຝັ່ງໃດຝັ່ງໜຶ່ງໄດ້ຕາມລຳພັງ. ເມື່ອຝັ່ງໜຶ່ງເອີ້ນ tool, ຜົນລັບທີ່ທ່ານສົ່ງຈະສືບຕໍ່ສະເພາະຝັ່ງນັ້ນ.
ແບ່ງປັນ, ສົ່ງອອກ ແລະ ນຳເຂົ້າ
- Copy share link ຫໍ່ການສົນທະນາເຂົ້າໃນລິ້ງເອງ, ໃນສ່ວນຫຼັງ
#. ບໍ່ມີຫຍັງຖືກອັບໂຫຼດ. ຮູບພາບ, key ຂອງທ່ານ ແລະ ລາຍລະອຽດຂອງການຮັນຄັ້ງສຸດທ້າຍຈະຖືກຕັດອອກ. ຜູ້ທີ່ເປີດລິ້ງຈະໄດ້ການສົນທະນາເປັນອັນໃໝ່ໃນ playground ຂອງຕົນເອງ. - ການສົນທະນາທີ່ຍາວເກີນໄປສຳລັບລິ້ງຈະຖືກປະຕິເສດພ້ອມໝາຍເຫດ. ໃຫ້ດາວໂຫຼດເປັນ JSON ແທນ.
- Download conversation JSON ບັນທຶກການສົນທະນາພ້ອມການຕັ້ງຄ່າເປັນໄຟລ໌. Import JSON ໃນ panel ການສົນທະນາເປີດໄຟລ໌ແບບນັ້ນ.
- Copy as cURL ຄັດລອກຄຳຮ້ອງຂໍປັດຈຸບັນເປັນຄຳສັ່ງ cURL ໜຶ່ງອັນ.
ສິ່ງທີ່ເກັບຢູ່ບ່ອນໃດ
| ສິ່ງໃດ | ເກັບໄວ້ບ່ອນໃດ |
|---|---|
| ການສົນທະນາ, tools ທີ່ບັນທຶກ, model ຫຼ້າສຸດ, ໂຄງຮ່າງ panel | ໃນບຣາວເຊີນີ້. ພວກມັນບໍ່ຖືກສົ່ງໄປ Shannon ແລະ ບໍ່ຕິດຕາມທ່ານໄປອຸປະກອນອື່ນ. |
| API key | ໃນໜ່ວຍຄວາມຈຳຂອງແຖບທີ່ເປີດຢູ່. key ທີ່ວາງໄວ້ຈະຫາຍໄປເມື່ອໂຫຼດໜ້າໃໝ່ ຫຼື ປິດແຖບ. ເມື່ອເຂົ້າສູ່ລະບົບແລ້ວ, key ຖືກອ່ານຈາກບັນຊີຂອງທ່ານທຸກຄັ້ງ. |
| Stream event, header ແລະ ຄຳຮ້ອງຂໍຂອງຮອບສຸດທ້າຍ | ໃນໜ້າທີ່ເປີດຢູ່, ຈົນກວ່າຈະໂຫຼດໃໝ່. |
| ຄຳຮ້ອງຂໍ | ສົ່ງຈາກບຣາວເຊີຂອງທ່ານໄປຫາ API ດ້ວຍ key ຂອງທ່ານ. ພວກມັນຖືກນັບຈາກຍອດເງິນຂອງທ່ານຄືກັບຄຳຮ້ອງຂໍ API ອື່ນ. |
ແປ້ນພິມ
| ປຸ່ມ | ມັນເຮັດຫຍັງ |
|---|---|
Enter | ສົ່ງຂໍ້ຄວາມ. |
Shift + Enter | ເລີ່ມແຖວໃໝ່. |
Ctrl + K | ເປີດ command palette: ປ່ຽນ endpoint ຫຼື model, ຕັ້ງ system template, ເລີ່ມການສົນທະນາໃໝ່, ເປີດ/ປິດ streaming, tools ຫຼື compare. ໃນ Mac: ⌘ K. |
Esc | ຢຸດຄຳຕອບທີ່ກຳລັງຖືກຂຽນ, ຫຼື ປິດ panel ທີ່ເປີດຢູ່ໃນໜ້າຈໍແຄບ. |