Chuyển đến nội dung
Nhật ký thay đổi

Nhật ký thay đổi

Các cập nhật và cải tiến gần đây của Shannon API.

Trang này liệt kê những thay đổi mà bạn, với tư cách người gọi API, có thể quan sát được: endpoint, trường và model mới, hành vi thay đổi và các bản sửa lỗi. Các mục mới nhất ở đầu. Mỗi mục mang ngày thay đổi được thực hiện.

Một mục được đánh dấu Thay đổi gây lỗi có thể làm thay đổi kết quả của một yêu cầu trước đó vẫn chạy được. API chỉ có một phiên bản, /v1, nên các thay đổi được liệt kê theo ngày chứ không theo số phiên bản.

  • Mới

    Yêu cầu gửi web_search: true nêu tên các nguồn của nó: sources trên /v1/chat/completions và /v1/messages liệt kê các kết quả đã đưa cho model, và trên /v1/chat/completions, annotations đánh dấu vị trí câu trả lời trích dẫn từng nguồn. Tìm kiếm web tích hợp

  • Mới

    web_search: true trên /v1/chat/completions và /v1/messages chạy một lượt tìm kiếm web trước khi model trả lời và đưa cho nó kết quả dưới dạng các nguồn được đánh số. Yêu cầu tìm thấy kết quả dùng một lượt tìm kiếm trong hạn mức hàng ngày của bạn. Khi hết lượt, yêu cầu được trả lời mà không tìm kiếm. Tìm kiếm web tích hợp

  • Đã sửa

    Stream bị cắt ở phía server được tính phí theo usage đã báo đến thời điểm đó. Phần còn lại của khoản giữ chỗ được trả về số dư của bạn.

  • Đã sửa

    shannon-coder-1 trả lời trên /v1/responses như trên hai endpoint còn lại. Công cụ lập trình CLI

  • Đã sửa

    API key đã xoay vòng ngừng hoạt động ngay lập tức.

  • Mới

    POST /v1/tokenize và POST /v1/messages/count_tokens: đếm token miễn phí cho các model open-weight hosted. Đếm token

  • Mới

    Prompt caching trên các model open-weight hosted. Đầu vào cached được tính phí bằng 25% giá input và được báo trong usage trên cả ba endpoint: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens và cache_read_input_tokens. GET /v1/models báo pricing.cached_input_per_million_usd và capabilities.prompt_caching cho các model này. Caching prompt

  • Đã sửa

    Các model open-weight hosted: tool_choice bắt buộc (required hoặc một hàm có tên) cho ra một lần gọi tool. Gọi hàm

  • Đã sửa

    Các model open-weight hosted chấp nhận tin nhắn system không phải là tin nhắn đầu tiên của cuộc hội thoại.

  • Mới

    API truy cập được dưới dạng dịch vụ onion Tor và tại một địa chỉ I2P. Các phản hồi của api.shannon-ai.com mang hai địa chỉ này trong header Onion-Location và X-I2P-Location. Các endpoint được mã hóa, Tor và I2P

  • Mới

    Các model mới shannon-3.1 và shannon-3.1-pro, được liệt kê bởi GET /v1/models. Model và giá

  • Đã thay đổi

    Yêu cầu streaming mà client ngắt kết nối vẫn chạy đến cùng và được tính. Trước đây, câu trả lời dừng ngay khi ngắt kết nối.

  • Đã sửa

    Các yêu cầu tới /v1/responses xuất hiện trong nhật ký sử dụng.

  • Mới

    Các model open-weight hosted áp dụng các trường lấy mẫu: temperature, top_p, seed, stop và max_tokens trên /v1/chat/completions; temperature, top_p và stop_sequences trên /v1/messages; temperature, top_p và max_output_tokens trên /v1/responses. Chat Completions

  • Mới

    Nhật ký sử dụng hiển thị chi phí bằng USD cho từng lần gọi và cho tổng.

  • Thay đổi gây lỗi

    Giá trị model không phải là id đã công bố được trả lời bằng 400, loại invalid_request_error và thông báo unknown model: <id> trên cả ba endpoint. Trước đây, yêu cầu như vậy được shannon-1.6-lite trả lời. Model và giá

  • Thay đổi gây lỗi

    /v1 chỉ nhận API key. Cookie đăng nhập của website không được đọc ở đó. Xác thực

  • Đã thay đổi

    Flood protection: 120 yêu cầu mỗi phút cho mỗi tài khoản trên ba endpoint tạo nội dung. Giới hạn và số dư

  • Đã cải thiện

    Khi model không thể trả lời, lỗi mang thông báo cố định The model backend failed to answer. Please retry. Việc kiểm tra số dư không thực hiện được sẽ được trả lời bằng 503 và loại api_error. Xử lý lỗi

  • Đã sửa

    Yêu cầu không streaming bị lỗi sẽ trả lại khoản giữ chỗ về số dư của bạn.

  • Mới

    GET /v1/models báo capabilities.reasoning_effort cho từng model. Mức độ suy luận

  • Đã cải thiện

    Các model open-weight hosted: yêu cầu không streaming không nhận được câu trả lời sẽ kết thúc bằng 504 và loại api_error. Kết quả rỗng là 502. Xử lý lỗi

  • Thay đổi gây lỗi

    Các model open-weight hosted nhận đầu vào mà model được nêu tên nhận. Một hình ảnh gửi tới id chỉ hỗ trợ văn bản được trả lời bằng 400 và <id> does not accept image input. response_format trên id không có đầu ra có cấu trúc được trả lời bằng 400. GET /v1/models báo capabilities.vision, response_format và json_schema cho từng id. Hình ảnh và tệp

  • Đã sửa

    Các phản hồi không streaming mang văn bản suy luận: reasoning_content trên message của /v1/chat/completions, và một block thinking đặt trước văn bản trên /v1/messages. Mức độ suy luận

  • Đã thay đổi

    Các model open-weight hosted có giá mới, từ $0.50 mỗi 1M token đầu vào và $2.00 mỗi 1M token đầu ra. Model và giá

  • Đã thay đổi

    Các model open-weight hosted có một id cho mỗi model, tổng cộng mười hai id. Model và giá

  • Mới

    Đầu ra có cấu trúc trên shannon-3, shannon-3-pro, shannon-3.1 và shannon-3.1-pro. GET /v1/models báo capabilities.json_schema: true cho chúng. Đầu ra có cấu trúc

  • Mới

    /v1/responses đọc text.format (json_object hoặc json_schema) cho đầu ra có cấu trúc. Responses API

  • Đã sửa

    /v1/responses trả về phần suy luận của các model Shannon: một mục đầu ra reasoning đặt trước mục message, và các sự kiện stream response.reasoning_summary_text.delta và response.reasoning_summary_text.done. Responses API

  • Đã sửa

    Trường model của phản hồi là id đã công bố trên mọi endpoint. Một đối tượng Responses mang model và created_at.

  • Đã cải thiện

    GET /v1/models báo cửa sổ ngữ cảnh của từng model. Model và giá

  • Mới

    Các model open-weight hosted trả lời trên /v1/messages và /v1/responses cũng như trên /v1/chat/completions, với system prompt và các lần gọi tool của bạn. /v1/messages nhận thinking, và reasoning_effort là một trường yêu cầu. Model và giá

  • Đã cải thiện

    Nội dung lỗi trên /v1 theo cấu trúc của các SDK: một đối tượng error với type và message trên các endpoint định dạng OpenAI, và cùng đối tượng đó bên trong {"type": "error"} trên /v1/messages. Xử lý lỗi

  • Mới

    Keep-alive trên các stream đang mở cứ 15 giây một lần: một dòng chú thích : ping trên /v1/chat/completions, một event: ping trên /v1/messages. Truyền phát

  • Đã thay đổi

    Id của lần gọi tool bắt đầu bằng call_ trên /v1/chat/completions và /v1/responses, và bằng toolu_ trên /v1/messages. Gọi hàm

  • Thay đổi gây lỗi

    /v1/responses: stream mặc định là false. Responses API

  • Mới

    max_completion_tokens được chấp nhận như một tên khác của max_tokens trên /v1/chat/completions. Chat Completions

  • Đã sửa

    Sự kiện response.completed của một stream Responses mang mảng output. Responses API

  • Mới

    Các phần tử của GET /v1/models mang display_name, context_window, max_output_tokens, pricing, capabilities và endpoints. Model và giá

  • Mới

    Mọi phản hồi đều mang x-request-id, và giá trị bạn gửi được trả lại. Nội dung yêu cầu có thể lớn tới 32 MiB.

  • Mới

    Một key có thể bị thu hồi mà không cấp key mới. Nhật ký sử dụng được phân trang.

  • Mới

    Hình ảnh và tài liệu trong yêu cầu: phần image_url trên /v1/chat/completions, block image, document và file trên /v1/messages, phần input_image trên /v1/responses. Hình ảnh và tệp

  • Mới

    Model mới shannon-3-pro. Model và giá

  • Đã thay đổi

    max_tokens được giữ trong khoảng 1 đến 65,536. Giá trị ngoài khoảng đó được đưa về đầu mút gần nhất, không bị từ chối. Chat Completions

  • Mới

    shannon-coder-1 được tính theo số lượt gọi trên mỗi gói trên /v1/chat/completions và /v1/messages. Khi số lượt gọi của một khung thời gian đã dùng hết, phản hồi là 429 với thông báo Shannon Coder call quota reached. Công cụ lập trình CLI

  • Mới

    Cuộc hội thoại lớn hơn cửa sổ ngữ cảnh được trả lời bằng 400, loại invalid_request_error và mã context_length_exceeded. Lỗi bên trong một stream đến dưới dạng sự kiện lỗi, không phải văn bản trong câu trả lời. Công cụ lập trình CLI

  • Mới

    Các endpoint /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses và GET /v1/models. Đây là các endpoint mà OpenAI SDK và Anthropic SDK, Claude Code và Codex CLI gọi tới. Tổng quan

  • Mới

    Gọi tool bằng tools trên /v1/chat/completions và /v1/messages, đầu ra có cấu trúc bằng response_format, và system dưới dạng chuỗi hoặc block văn bản trên /v1/messages. Gọi hàm

  • Mới

    Các model id shannon-1.6-pro, shannon-2-lite, shannon-2-pro và shannon-coder-1, bên cạnh shannon-1.6-lite. Model và giá

  • Mới

    Bản phát hành đầu tiên của API: chat theo định dạng OpenAI và theo định dạng Anthropic, cùng một endpoint Responses, mỗi endpoint được gọi bằng một API key bắt đầu bằng sk-. Xác thực