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: truenêu tên các nguồn của nó:sourcestrên/v1/chat/completionsvà/v1/messagesliệ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: truetrên/v1/chat/completionsvà/v1/messageschạ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-1trả lời trên/v1/responsesnhư 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/tokenizevà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
usagetrên cả ba endpoint:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensvàcache_read_input_tokens.GET /v1/modelsbáopricing.cached_input_per_million_usdvàcapabilities.prompt_cachingcho các model này. Caching prompt - Đã sửa
Các model open-weight hosted:
tool_choicebắt buộc (requiredhoặ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
systemkhô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.commang hai địa chỉ này trong headerOnion-LocationvàX-I2P-Location. Các endpoint được mã hóa, Tor và I2P
- Mới
Các model mới
shannon-3.1vàshannon-3.1-pro, được liệt kê bởiGET /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/responsesxuấ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,stopvàmax_tokenstrên/v1/chat/completions;temperature,top_pvàstop_sequencestrên/v1/messages;temperature,top_pvàmax_output_tokenstrê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ị
modelkhông phải là id đã công bố được trả lời bằng400, loạiinvalid_request_errorvà thông báounknown model: <id>trên cả ba endpoint. Trước đây, yêu cầu như vậy đượcshannon-1.6-litetrả lời. Model và giá - Thay đổi gây lỗi
/v1chỉ 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ằng503và loạiapi_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/modelsbáocapabilities.reasoning_effortcho 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
504và loạiapi_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
400và<id> does not accept image input.response_formattrên id không có đầu ra có cấu trúc được trả lời bằng400.GET /v1/modelsbáocapabilities.vision,response_formatvàjson_schemacho 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_contenttrên message của/v1/chat/completions, và một blockthinkingđặ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.1vàshannon-3.1-pro.GET /v1/modelsbáocapabilities.json_schema: truecho chúng. Đầu ra có cấu trúc - Mới
/v1/responsesđọctext.format(json_objecthoặcjson_schema) cho đầu ra có cấu trúc. Responses API - Đã sửa
/v1/responsestrả về phần suy luận của các model Shannon: một mục đầu rareasoningđặt trước mụcmessage, và các sự kiện streamresponse.reasoning_summary_text.deltavàresponse.reasoning_summary_text.done. Responses API - Đã sửa
Trường
modelcủa phản hồi là id đã công bố trên mọi endpoint. Một đối tượng Responses mangmodelvàcreated_at. - Đã cải thiện
GET /v1/modelsbá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/messagesvà/v1/responsescũng như trên/v1/chat/completions, với system prompt và các lần gọi tool của bạn./v1/messagesnhậnthinking, vàreasoning_effortlà một trường yêu cầu. Model và giá - Đã cải thiện
Nội dung lỗi trên
/v1theo cấu trúc của các SDK: một đối tượngerrorvớitypevàmessagetrê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
: pingtrên/v1/chat/completions, mộtevent: pingtrê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/completionsvà/v1/responses, và bằngtoolu_trên/v1/messages. Gọi hàm - Thay đổi gây lỗi
/v1/responses:streammặc định làfalse. Responses API - Mới
max_completion_tokensđược chấp nhận như một tên khác củamax_tokenstrên/v1/chat/completions. Chat Completions - Đã sửa
Sự kiện
response.completedcủa một stream Responses mang mảngoutput. Responses API - Mới
Các phần tử của
GET /v1/modelsmangdisplay_name,context_window,max_output_tokens,pricing,capabilitiesvà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_urltrên/v1/chat/completions, blockimage,documentvàfiletrên/v1/messages, phầninput_imagetrên/v1/responses. Hình ảnh và tệp - Mới
Model mới
shannon-3-pro. Model và giá
- Mới
Model mới
shannon-3. Model và giá - Mới
Các stream trên
/v1/chat/completionsmang phần suy luận dưới dạngdelta.reasoning_content. Mức độ suy luận
- Đã 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/completionsvà/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à429với thông báoShannon 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ạiinvalid_request_errorvà 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/responsesvà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
toolstrên/v1/chat/completionsvà/v1/messages, đầu ra có cấu trúc bằngresponse_format, vàsystemdướ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-provàshannon-coder-1, bên cạnhshannon-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