บันทึกการเปลี่ยนแปลง
การอัปเดตและการปรับปรุงล่าสุดของ Shannon API
หน้านี้แสดงรายการการเปลี่ยนแปลงที่ผู้เรียกใช้ API สังเกตเห็นได้: endpoint ฟิลด์ และโมเดลใหม่ พฤติกรรมที่เปลี่ยนไป และการแก้ไข รายการล่าสุดอยู่ก่อน แต่ละรายการระบุวันที่ที่เปลี่ยนแปลง
รายการที่ทำเครื่องหมาย เปลี่ยนแปลงที่ไม่เข้ากันกับของเดิม อาจเปลี่ยนผลลัพธ์ของคำขอที่เคยใช้ได้ API มีเวอร์ชันเดียวคือ /v1 จึงแสดงรายการการเปลี่ยนแปลงตามวันที่ ไม่ใช่ตามหมายเลขเวอร์ชัน
- ใหม่
คำขอที่มี
web_search: trueระบุแหล่งที่มาของตน:sourcesบน/v1/chat/completionsและ/v1/messagesแสดงรายการผลลัพธ์ที่ส่งให้โมเดล และบน/v1/chat/completionsannotationsระบุว่าคำตอบอ้างอิงแต่ละรายการตรงไหน ค้นหาเว็บในตัว
- ใหม่
web_search: trueบน/v1/chat/completionsและ/v1/messagesจะค้นหาเว็บก่อนที่โมเดลตอบ และส่งผลลัพธ์ให้โมเดลเป็นแหล่งที่มาที่มีหมายเลขกำกับ คำขอที่พบผลลัพธ์จะใช้การค้นหาหนึ่งครั้งจากโควตารายวันของคุณ เมื่อไม่เหลือแล้ว คำขอจะถูกตอบโดยไม่มีการค้นหา ค้นหาเว็บในตัว
- แก้ไขแล้ว
สตรีมที่ถูกตัดจากฝั่งเซิร์ฟเวอร์จะถูกเรียกเก็บตาม usage ที่รายงานจนถึงจุดนั้น ส่วนที่เหลือของยอดที่กันไว้จะคืนเข้ายอดคงเหลือของคุณ
- แก้ไขแล้ว
shannon-coder-1ตอบบน/v1/responsesเช่นเดียวกับที่ตอบบนอีกสอง endpoint เครื่องมือเขียนโค้ดแบบ CLI - แก้ไขแล้ว
API key ที่หมุนเวียนแล้วจะหยุดทำงานทันที
- ใหม่
POST /v1/tokenizeและPOST /v1/messages/count_tokens: นับ tokens ได้ฟรีสำหรับโมเดล open-weight ที่โฮสต์ การนับ token - ใหม่
Prompt caching บนโมเดล open-weight ที่โฮสต์ อินพุตที่แคชไว้คิดราคา 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สำหรับโมเดลเหล่านี้ การแคชพรอมต์ - แก้ไขแล้ว
โมเดล open-weight ที่โฮสต์:
tool_choiceแบบบังคับ (requiredหรือฟังก์ชันที่ระบุชื่อ) จะให้ผลเป็นการเรียก tool การเรียกฟังก์ชัน - แก้ไขแล้ว
โมเดล open-weight ที่โฮสต์รับข้อความ
systemที่ไม่ใช่ข้อความแรกของบทสนทนา
- ใหม่
เข้าถึง API ได้ผ่าน Tor onion service และที่อยู่ I2P คำตอบของ
api.shannon-ai.comมีทั้งสองที่อยู่ในเฮดเดอร์Onion-LocationและX-I2P-LocationEndpoint แบบเข้ารหัส, Tor และ I2P
- ใหม่
โมเดลใหม่
shannon-3.1และshannon-3.1-proซึ่งแสดงรายการโดยGET /v1/modelsโมเดลและราคา - เปลี่ยนแปลง
คำขอแบบสตรีมที่ไคลเอนต์ตัดการเชื่อมต่อจะทำงานต่อจนจบและถูกนับ ก่อนหน้านี้คำตอบจะหยุดเมื่อมีการตัดการเชื่อมต่อ
- แก้ไขแล้ว
คำขอไปยัง
/v1/responsesปรากฏในบันทึกการใช้งาน
- ใหม่
โมเดล open-weight ที่โฮสต์ใช้ฟิลด์ 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/responsesChat Completions - ใหม่
บันทึกการใช้งานแสดงค่าใช้จ่ายเป็น USD สำหรับแต่ละการเรียกและเป็นยอดรวม
- เปลี่ยนแปลงที่ไม่เข้ากันกับของเดิม
ค่า
modelที่ไม่ใช่ id ที่เผยแพร่จะได้รับ400ประเภทinvalid_request_errorและข้อความunknown model: <id>บนทั้งสาม endpoint ก่อนหน้านี้คำขอลักษณะนั้นจะถูกตอบโดยshannon-1.6-liteโมเดลและราคา - เปลี่ยนแปลงที่ไม่เข้ากันกับของเดิม
/v1รับเฉพาะ API key เท่านั้น คุกกี้การลงชื่อเข้าใช้ของเว็บไซต์จะไม่ถูกอ่านที่นั่น การยืนยันตัวตน - เปลี่ยนแปลง
Flood protection: 120 คำขอต่อนาทีต่อบัญชี บนสาม endpoint สำหรับสร้างคำตอบ ขีดจำกัดและยอดคงเหลือ
- ปรับปรุงแล้ว
เมื่อโมเดลตอบไม่ได้ ข้อผิดพลาดจะมีข้อความคงที่
The model backend failed to answer. Please retry.ส่วนการตรวจยอดคงเหลือที่ทำไม่ได้จะได้รับ503และประเภทapi_errorการจัดการข้อผิดพลาด - แก้ไขแล้ว
คำขอแบบไม่สตรีมที่ล้มเหลวจะคืนยอดที่กันไว้กลับเข้ายอดคงเหลือของคุณ
- ใหม่
GET /v1/modelsรายงานcapabilities.reasoning_effortสำหรับแต่ละโมเดล ระดับความพยายามในการให้เหตุผล - ปรับปรุงแล้ว
โมเดล open-weight ที่โฮสต์: คำขอแบบไม่สตรีมที่ไม่ได้รับคำตอบจะจบด้วย
504และประเภทapi_errorผลลัพธ์ว่างเปล่าคือ502การจัดการข้อผิดพลาด
- เปลี่ยนแปลงที่ไม่เข้ากันกับของเดิม
โมเดล open-weight ที่โฮสต์รับอินพุตตามที่โมเดลที่ระบุชื่อรับได้ รูปภาพที่ส่งไปยัง id แบบข้อความล้วนจะได้รับ
400และ<id> does not accept image inputส่วนresponse_formatบน id ที่ไม่รองรับเอาต์พุตแบบมีโครงสร้างจะได้รับ400GET /v1/modelsรายงานcapabilities.vision,response_formatและjson_schemaสำหรับแต่ละ id รูปภาพและไฟล์ - แก้ไขแล้ว
คำตอบแบบไม่สตรีมมีข้อความการให้เหตุผล:
reasoning_contentบน message ของ/v1/chat/completionsและบล็อกthinkingก่อนข้อความบน/v1/messagesระดับความพยายามในการให้เหตุผล - เปลี่ยนแปลง
โมเดล open-weight ที่โฮสต์มีราคาใหม่ เริ่มที่ $0.50 ต่อ 1M input tokens และ $2.00 ต่อ 1M output tokens โมเดลและราคา
- เปลี่ยนแปลง
โมเดล open-weight ที่โฮสต์มีหนึ่ง id ต่อหนึ่งโมเดล รวมสิบสอง id โมเดลและราคา
- ใหม่
เอาต์พุตแบบมีโครงสร้างบน
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) สำหรับเอาต์พุตแบบมีโครงสร้าง Responses API - แก้ไขแล้ว
/v1/responsesคืนการให้เหตุผลของโมเดล Shannon: รายการเอาต์พุตreasoningก่อนรายการmessageและอีเวนต์สตรีมresponse.reasoning_summary_text.deltaและresponse.reasoning_summary_text.doneResponses API - แก้ไขแล้ว
ฟิลด์
modelของคำตอบคือ id ที่เผยแพร่ในทุก endpoint ออบเจกต์ Responses มีmodelและcreated_at - ปรับปรุงแล้ว
GET /v1/modelsรายงาน context window ของแต่ละโมเดล โมเดลและราคา
- ใหม่
โมเดล open-weight ที่โฮสต์ตอบได้บน
/v1/messagesและ/v1/responsesเช่นเดียวกับ/v1/chat/completionsโดยใช้ system prompt และการเรียก tool ของคุณ/v1/messagesรับthinkingและreasoning_effortเป็นฟิลด์ของคำขอ โมเดลและราคา - ปรับปรุงแล้ว
error body บน
/v1เป็นไปตามรูปแบบของ SDK: ออบเจกต์errorที่มีtypeและmessageบน endpoint รูปแบบ OpenAI และออบเจกต์เดียวกันภายใน{"type": "error"}บน/v1/messagesการจัดการข้อผิดพลาด - ใหม่
Keep-alive บนสตรีมที่เปิดอยู่ทุก 15 วินาที: บรรทัดคอมเมนต์
: pingบน/v1/chat/completionsและevent: pingบน/v1/messagesสตรีมมิง - เปลี่ยนแปลง
id ของการเรียก tool ขึ้นต้นด้วย
call_บน/v1/chat/completionsและ/v1/responsesและขึ้นต้นด้วยtoolu_บน/v1/messagesการเรียกฟังก์ชัน - เปลี่ยนแปลงที่ไม่เข้ากันกับของเดิม
/v1/responses: ค่าเริ่มต้นของstreamคือfalseResponses API - ใหม่
รับ
max_completion_tokensเป็นอีกชื่อหนึ่งของmax_tokensบน/v1/chat/completionsChat Completions - แก้ไขแล้ว
อีเวนต์
response.completedของสตรีม Responses มีอาร์เรย์outputResponses API - ใหม่
รายการใน
GET /v1/modelsมีdisplay_name,context_window,max_output_tokens,pricing,capabilitiesและendpointsโมเดลและราคา - ใหม่
ทุกคำตอบมี
x-request-idและค่าที่คุณส่งมาจะถูกส่งกลับ body ของคำขอใหญ่ได้สูงสุด 32 MiB - ใหม่
เพิกถอนคีย์ได้โดยไม่ต้องออกคีย์ใหม่ บันทึกการใช้งานแบ่งเป็นหน้า
- ใหม่
รูปภาพและเอกสารในคำขอ: ส่วน
image_urlบน/v1/chat/completions, บล็อกimage,documentและfileบน/v1/messages, ส่วนinput_imageบน/v1/responsesรูปภาพและไฟล์ - ใหม่
โมเดลใหม่
shannon-3-proโมเดลและราคา
- ใหม่
โมเดลใหม่
shannon-3โมเดลและราคา - ใหม่
สตรีมบน
/v1/chat/completionsส่งการให้เหตุผลเป็นdelta.reasoning_contentระดับความพยายามในการให้เหตุผล
- เปลี่ยนแปลง
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ข้อผิดพลาดภายในสตรีมจะมาถึงเป็นอีเวนต์ข้อผิดพลาด ไม่ใช่ข้อความในคำตอบ เครื่องมือเขียนโค้ดแบบ CLI
- ใหม่
endpoint ของ
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesและGET /v1/modelsเป็น endpoint ที่ OpenAI และ Anthropic SDK, Claude Code และ Codex CLI เรียกใช้ ภาพรวม - ใหม่
การเรียก tool ด้วย
toolsบน/v1/chat/completionsและ/v1/messagesเอาต์พุตแบบมีโครงสร้างด้วยresponse_formatและsystemเป็นสตริงหรือบล็อกข้อความบน/v1/messagesการเรียกฟังก์ชัน
- ใหม่
model id
shannon-1.6-pro,shannon-2-lite,shannon-2-proและshannon-coder-1เพิ่มเข้ามาถัดจากshannon-1.6-liteโมเดลและราคา
- ใหม่
การเปิดตัว API ครั้งแรก: แชตในรูปแบบ OpenAI และรูปแบบ Anthropic พร้อม endpoint Responses โดยเรียกใช้ด้วย API key ที่ขึ้นต้นด้วย
sk-การยืนยันตัวตน