ບັນທຶກການປ່ຽນແປງ

ຄຳຮ້ອງຂໍທີ່ມີ web_search: true ບອກຊື່ແຫຼ່ງຂອງມັນ: sources ໃນ /v1/chat/completions ແລະ /v1/messages ລະບຸຜົນລັບທີ່ model ໄດ້ຮັບ, ແລະໃນ /v1/chat/completions annotations ໝາຍວ່າຄຳຕອບອ້າງອີງແຕ່ລະອັນຢູ່ບ່ອນໃດ. ຄົ້ນຫາເວັບ

web_search: true ໃນ /v1/chat/completions ແລະ /v1/messages ຈະຄົ້ນຫາເວັບກ່ອນທີ່ model ຕອບ ແລະ ສົ່ງຜົນໃຫ້ມັນເປັນແຫຼ່ງອ້າງອີງທີ່ມີເລກລຳດັບ. ຄຳຮ້ອງຂໍທີ່ພົບຜົນຈະໃຊ້ການຄົ້ນຫາໜຶ່ງຄັ້ງຈາກໂຄວຕາປະຈຳວັນຂອງທ່ານ. ຖ້າບໍ່ເຫຼືອ, ຄຳຮ້ອງຂໍຈະຖືກຕອບໂດຍບໍ່ມີການຄົ້ນຫາ. ຄົ້ນຫາເວັບ

stream ທີ່ຖືກຕັດຝັ່ງ server ຖືກຄິດເງິນຕາມ usage ທີ່ລາຍງານມາຮອດຈຸດນັ້ນ. ສ່ວນທີ່ເຫຼືອຂອງຍອດທີ່ກັນໄວ້ຈະຄືນເຂົ້າຍອດເງິນຂອງທ່ານ.

shannon-coder-1 ຕອບໃນ /v1/responses ຄືກັບທີ່ຕອບໃນສອງ endpoint ອື່ນ. ເຄື່ອງມື CLI ສຳລັບຂຽນໂຄ້ດ

API key ທີ່ຖືກປ່ຽນຈະຢຸດໃຊ້ງານທັນທີ.

POST /v1/tokenize ແລະ POST /v1/messages/count_tokens: ນັບ tokens ໂດຍບໍ່ເສຍຄ່າ ສຳລັບ hosted open-weight models. ການນັບ token

Prompt caching ໃນ hosted open-weight models. Cached input ຖືກຄິດເງິນໃນລາຄາ 25% ຂອງລາຄາ input ແລະ ລາຍງານໃນ usage ທັງສາມ endpoint: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens ແລະ cache_read_input_tokens. GET /v1/models ລາຍງານ pricing.cached_input_per_million_usd ແລະ capabilities.prompt_caching ສຳລັບ model ເຫຼົ່ານີ້. ການ Cache Prompt

Hosted open-weight models: tool_choice ແບບບັງຄັບ (required ຫຼື function ທີ່ລະບຸຊື່) ໃຫ້ການເອີ້ນ tool. ການເອີ້ນຟັງຊັນ

Hosted open-weight models ຮັບຂໍ້ຄວາມ system ທີ່ບໍ່ແມ່ນຂໍ້ຄວາມທຳອິດຂອງບົດສົນທະນາ.

API ເຂົ້າເຖິງໄດ້ເປັນ Tor onion service ແລະ ທີ່ທີ່ຢູ່ I2P. ຄຳຕອບຂອງ api.shannon-ai.com ມີສອງທີ່ຢູ່ໃນ header Onion-Location ແລະ X-I2P-Location. Endpoint ແບບເຂົ້າລະຫັດ, Tor ແລະ I2P

Model ໃໝ່ shannon-3.1 ແລະ shannon-3.1-pro, ລະບຸໂດຍ GET /v1/models. Model ແລະ ລາຄາ

ຄຳຮ້ອງຂໍແບບ stream ທີ່ client ຕັດການເຊື່ອມຕໍ່ຈະເຮັດວຽກຈົນຈົບ ແລະ ຖືກນັບ. ກ່ອນນີ້, ຄຳຕອບຢຸດຕອນຕັດການເຊື່ອມຕໍ່.

ຄຳຮ້ອງຂໍໄປ /v1/responses ປະກົດໃນ usage log.

Hosted open-weight models ໃຊ້ຟີວ sampling: temperature, top_p, seed, stop ແລະ max_tokens ໃນ /v1/chat/completions; temperature, top_p ແລະ stop_sequences ໃນ /v1/messages; temperature, top_p ແລະ max_output_tokens ໃນ /v1/responses. Chat Completions

usage log ສະແດງຄ່າໃຊ້ຈ່າຍເປັນ USD ສຳລັບແຕ່ລະການເອີ້ນ ແລະ ເປັນຍອດລວມ.

ຄ່າ model ທີ່ບໍ່ແມ່ນ id ທີ່ເຜີຍແຜ່ ຖືກຕອບດ້ວຍ 400, ປະເພດ invalid_request_error ແລະ ຂໍ້ຄວາມ unknown model: <id> ໃນທັງສາມ endpoint. ກ່ອນນີ້, ຄຳຮ້ອງຂໍແບບນັ້ນຖືກຕອບໂດຍ shannon-1.6-lite. Model ແລະ ລາຄາ

/v1 ຮັບສະເພາະ API key. cookie ການເຂົ້າສູ່ລະບົບຂອງເວັບໄຊຖືກບໍ່ອ່ານທີ່ນັ້ນ. ການຢືນຢັນ

Flood protection: 120 ຄຳຮ້ອງຂໍຕໍ່ນາທີຕໍ່ບັນຊີ ໃນສາມ endpoint ສ້າງຄຳຕອບ. ຂີດຈຳກັດ ແລະ ຍອດເງິນ

ເມື່ອ model ຕອບບໍ່ໄດ້, ຂໍ້ຜິດພາດມີຂໍ້ຄວາມຄົງທີ່ The model backend failed to answer. Please retry. ການກວດຍອດເງິນທີ່ເຮັດບໍ່ໄດ້ຖືກຕອບດ້ວຍ 503 ແລະ ປະເພດ api_error. ການຈັດການຂໍ້ຜິດພາດ

ຄຳຮ້ອງຂໍທີ່ບໍ່ stream ແລະ ລົ້ມເຫຼວຈະຄືນຍອດທີ່ກັນໄວ້ເຂົ້າຍອດເງິນຂອງທ່ານ.

GET /v1/models ລາຍງານ capabilities.reasoning_effort ສຳລັບແຕ່ລະ model. Reasoning effort

Hosted open-weight models: ຄຳຮ້ອງຂໍທີ່ບໍ່ stream ແລະ ບໍ່ໄດ້ຄຳຕອບຈະຈົບດ້ວຍ 504 ແລະ ປະເພດ api_error. ຜົນວ່າງແມ່ນ 502. ການຈັດການຂໍ້ຜິດພາດ

Hosted open-weight models ຮັບ input ທີ່ model ທີ່ມີຊື່ນັ້ນຮັບ. ຮູບພາບທີ່ສົ່ງໄປຫາ id ທີ່ຮັບສະເພາະຂໍ້ຄວາມຖືກຕອບດ້ວຍ 400 ແລະ <id> does not accept image input. response_format ໃນ id ທີ່ບໍ່ມີ structured output ຖືກຕອບດ້ວຍ 400. GET /v1/models ລາຍງານ capabilities.vision, response_format ແລະ json_schema ສຳລັບແຕ່ລະ id. ຮູບພາບ ແລະ ໄຟລ໌

ຄຳຕອບທີ່ບໍ່ stream ມີຂໍ້ຄວາມ reasoning: reasoning_content ໃນຂໍ້ຄວາມຂອງ /v1/chat/completions, ແລະ block thinking ກ່ອນຂໍ້ຄວາມໃນ /v1/messages. Reasoning effort

Hosted open-weight models ມີລາຄາໃໝ່ ເລີ່ມຕົ້ນທີ່ $0.50 ຕໍ່ 1M ສຳລັບ input tokens ແລະ $2.00 ຕໍ່ 1M ສຳລັບ output tokens. Model ແລະ ລາຄາ

Hosted open-weight models ມີ id ໜຶ່ງອັນຕໍ່ໜຶ່ງ model, ລວມທັງໝົດສິບສອງ id. Model ແລະ ລາຄາ

Structured output ໃນ shannon-3, shannon-3-pro, shannon-3.1 ແລະ shannon-3.1-pro. GET /v1/models ລາຍງານ capabilities.json_schema: true ສຳລັບພວກມັນ. ຜົນອອກມີໂຄງສ້າງ

/v1/responses ອ່ານ text.format (json_object ຫຼື json_schema) ສຳລັບ structured output. Responses API

/v1/responses ສົ່ງຄືນ reasoning ຂອງ Shannon models: item output reasoning ກ່ອນ item message, ແລະ event ຂອງ stream response.reasoning_summary_text.delta ແລະ response.reasoning_summary_text.done. Responses API

ຟີວ model ຂອງຄຳຕອບແມ່ນ id ທີ່ເຜີຍແຜ່ໃນທຸກ endpoint. object Responses ມີ model ແລະ created_at.

GET /v1/models ລາຍງານ context window ຂອງແຕ່ລະ model. Model ແລະ ລາຄາ

Hosted open-weight models ຕອບໃນ /v1/messages ແລະ /v1/responses ເຊັ່ນດຽວກັບ /v1/chat/completions, ດ້ວຍ system prompt ແລະ ການເອີ້ນ tool ຂອງທ່ານ. /v1/messages ຮັບ thinking, ແລະ reasoning_effort ເປັນຟີວຂອງຄຳຮ້ອງຂໍ. Model ແລະ ລາຄາ

error body ໃນ /v1 ເປັນໄປຕາມຮູບແບບຂອງ SDK: object error ທີ່ມີ type ແລະ message ໃນ endpoint ຮູບແບບ OpenAI, ແລະ object ດຽວກັນພາຍໃນ {"type": "error"} ໃນ /v1/messages. ການຈັດການຂໍ້ຜິດພາດ

Keep-alive ໃນ stream ທີ່ເປີດຢູ່ທຸກ 15 ວິນາທີ: ແຖວ comment : ping ໃນ /v1/chat/completions, event: ping ໃນ /v1/messages. ສະຕຣີມມິ້ງ

id ຂອງການເອີ້ນ tool ຂຶ້ນຕົ້ນດ້ວຍ call_ ໃນ /v1/chat/completions ແລະ /v1/responses, ແລະ ດ້ວຍ toolu_ ໃນ /v1/messages. ການເອີ້ນຟັງຊັນ

/v1/responses: stream ມີຄ່າເລີ່ມຕົ້ນເປັນ false. Responses API

max_completion_tokens ຖືກຮັບໄວ້ເປັນຊື່ອື່ນຂອງ max_tokens ໃນ /v1/chat/completions. Chat Completions

ເຫດການ response.completed ຂອງ stream Responses ມີ array output ຢູ່ນຳ. Responses API

ລາຍການໃນ GET /v1/models ມີ display_name, context_window, max_output_tokens, pricing, capabilities ແລະ endpoints. Model ແລະ ລາຄາ

ທຸກຄຳຕອບມີ x-request-id, ແລະ ຄ່າທີ່ທ່ານສົ່ງມາຈະຖືກສົ່ງຄືນ. body ຂອງຄຳຮ້ອງຂໍໃຫຍ່ໄດ້ເຖິງ 32 MiB.

ຖອນ key ໄດ້ໂດຍບໍ່ຕ້ອງອອກ key ໃໝ່. usage log ແບ່ງເປັນໜ້າ.

ຮູບພາບ ແລະ ເອກະສານໃນຄຳຮ້ອງຂໍ: ສ່ວນ image_url ໃນ /v1/chat/completions, block image, document ແລະ file ໃນ /v1/messages, ສ່ວນ input_image ໃນ /v1/responses. ຮູບພາບ ແລະ ໄຟລ໌

Model ໃໝ່ shannon-3-pro. Model ແລະ ລາຄາ

Model ໃໝ່ shannon-3. Model ແລະ ລາຄາ

stream ໃນ /v1/chat/completions ສົ່ງ reasoning ເປັນ delta.reasoning_content. Reasoning effort

max_tokens ຖືກຮັກສາໄວ້ໃນຊ່ວງ 1 ຫາ 65,536. ຄ່າທີ່ຢູ່ນອກຊ່ວງນັ້ນຖືກປັບໄປຫາປາຍທີ່ໃກ້ທີ່ສຸດ, ບໍ່ຖືກປະຕິເສດ. Chat Completions

shannon-coder-1 ຖືກນັບເປັນຈຳນວນການເອີ້ນຕໍ່ແຜນໃນ /v1/chat/completions ແລະ /v1/messages. ເມື່ອການເອີ້ນຂອງໜ້າຕ່າງເວລາໝົດ, ຄຳຕອບແມ່ນ 429 ພ້ອມຂໍ້ຄວາມ Shannon Coder call quota reached. ເຄື່ອງມື CLI ສຳລັບຂຽນໂຄ້ດ

ບົດສົນທະນາທີ່ໃຫຍ່ກວ່າ context window ຖືກຕອບດ້ວຍ 400, ປະເພດ invalid_request_error ແລະ ລະຫັດ context_length_exceeded. ຂໍ້ຜິດພາດພາຍໃນ stream ມາເປັນ error event, ບໍ່ແມ່ນຂໍ້ຄວາມໃນຄຳຕອບ. ເຄື່ອງມື CLI ສຳລັບຂຽນໂຄ້ດ

endpoint /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses ແລະ GET /v1/models. ມັນແມ່ນ endpoint ທີ່ SDK ຂອງ OpenAI ແລະ Anthropic, Claude Code ແລະ Codex CLI ເອີ້ນໃຊ້. ພາບລວມ

ການເອີ້ນ tool ດ້ວຍ tools ໃນ /v1/chat/completions ແລະ /v1/messages, structured output ດ້ວຍ response_format, ແລະ system ເປັນ string ຫຼື ເປັນ text block ໃນ /v1/messages. ການເອີ້ນຟັງຊັນ

Model id shannon-1.6-pro, shannon-2-lite, shannon-2-pro ແລະ shannon-coder-1, ເພີ່ມຈາກ shannon-1.6-lite. Model ແລະ ລາຄາ

ການປ່ອຍ API ຄັ້ງທຳອິດ: chat ໃນຮູບແບບ OpenAI ແລະ ຮູບແບບ Anthropic, ແລະ endpoint Responses, ແຕ່ລະອັນເອີ້ນດ້ວຍ API key ທີ່ຂຶ້ນຕົ້ນດ້ວຍ sk-. ການຢືນຢັນ