ข้ามไปยังเนื้อหา
บันทึกการเปลี่ยนแปลง

บันทึกการเปลี่ยนแปลง

การอัปเดตและการปรับปรุงล่าสุดของ Shannon API

หน้านี้แสดงรายการการเปลี่ยนแปลงที่ผู้เรียกใช้ API สังเกตเห็นได้: endpoint ฟิลด์ และโมเดลใหม่ พฤติกรรมที่เปลี่ยนไป และการแก้ไข รายการล่าสุดอยู่ก่อน แต่ละรายการระบุวันที่ที่เปลี่ยนแปลง

รายการที่ทำเครื่องหมาย เปลี่ยนแปลงที่ไม่เข้ากันกับของเดิม อาจเปลี่ยนผลลัพธ์ของคำขอที่เคยใช้ได้ API มีเวอร์ชันเดียวคือ /v1 จึงแสดงรายการการเปลี่ยนแปลงตามวันที่ ไม่ใช่ตามหมายเลขเวอร์ชัน

  • ใหม่

    คำขอที่มี web_search: true ระบุแหล่งที่มาของตน: sources บน /v1/chat/completions และ /v1/messages แสดงรายการผลลัพธ์ที่ส่งให้โมเดล และบน /v1/chat/completions annotations ระบุว่าคำตอบอ้างอิงแต่ละรายการตรงไหน ค้นหาเว็บในตัว

  • ใหม่

    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-Location Endpoint แบบเข้ารหัส, 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/responses Chat 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 ที่ไม่รองรับเอาต์พุตแบบมีโครงสร้างจะได้รับ 400 GET /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.done Responses 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 คือ false Responses API

  • ใหม่

    รับ max_completion_tokens เป็นอีกชื่อหนึ่งของ max_tokens บน /v1/chat/completions Chat Completions

  • แก้ไขแล้ว

    อีเวนต์ response.completed ของสตรีม Responses มีอาร์เรย์ output Responses 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 โมเดลและราคา

  • เปลี่ยนแปลง

    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- การยืนยันตัวตน