ცვლილებების ჟურნალი

მოთხოვნა 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 გასაღები მაშინვე წყვეტს მუშაობას.

POST /v1/tokenize და POST /v1/messages/count_tokens: უფასო ტოკენების დათვლა hosted open-weight მოდელებისთვის. ტოკენების დათვლა

პრომპტის ქეშირება hosted open-weight მოდელებზე. ქეშირებული შემავალი შემავალი ტოკენების ფასის 25%-ად ირიცხება და სამივე endpoint-ზე usage-ში ჩანს: 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-ს. პრომპტის ქეშირება

Hosted open-weight მოდელები: იძულებითი tool_choice (required ან დასახელებული ფუნქცია) იძლევა ინსტრუმენტის გამოძახებას. ფუნქციის გამოძახება

Hosted open-weight მოდელები იღებენ system შეტყობინებას, რომელიც საუბრის პირველი შეტყობინება არ არის.

API ხელმისაწვდომია როგორც Tor onion სერვისი და I2P მისამართზე. api.shannon-ai.com-ის პასუხები ორივე მისამართს ატარებენ Onion-Location და X-I2P-Location header-ებში. დაშიფრული, Tor და I2P endpoint-ები

ახალი მოდელები shannon-3.1 და shannon-3.1-pro, რომლებსაც GET /v1/models ჩამოთვლის. მოდელები და ფასები

სტრიმული მოთხოვნა, რომლის კლიენტიც წყვეტს კავშირს, ბოლომდე სრულდება და ითვლება. მანამდე პასუხი კავშირის გაწყვეტისას ჩერდებოდა.

/v1/responses-ის მოთხოვნები გამოყენების ჟურნალში ჩანს.

Hosted open-weight მოდელები ითვალისწინებენ სემპლინგის ველებს: 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 არ არის, სამივე endpoint-ზე პასუხობს 400, ტიპი invalid_request_error და შეტყობინება unknown model: <id>. მანამდე ასეთ მოთხოვნას shannon-1.6-lite პასუხობდა. მოდელები და ფასები

/v1 იღებს მხოლოდ API გასაღებს. ვებსაიტზე შესვლის cookie იქ არ იკითხება. ავთენტიკაცია

Flood protection: 120 მოთხოვნა წუთში ანგარიშზე სამ გენერაციის endpoint-ზე. ლიმიტები და ბალანსი

როცა მოდელი ვერ პასუხობს, შეცდომა ატარებს ფიქსირებულ შეტყობინებას The model backend failed to answer. Please retry. ბალანსის შემოწმებას, რომლის შესრულებაც ვერ ხერხდება, პასუხობს 503 და ტიპი api_error. შეცდომების დამუშავება

არასტრიმული მოთხოვნა, რომელიც წარუმატებლად სრულდება, რეზერვს თქვენს ბალანსს უბრუნებს.

GET /v1/models თითოეული მოდელისთვის აჩვენებს capabilities.reasoning_effort-ს. მსჯელობის effort

Hosted open-weight მოდელები: არასტრიმული მოთხოვნა, რომელიც პასუხს ვერ იღებს, მთავრდება 504-ით და ტიპით api_error. ცარიელი შედეგი არის 502. შეცდომების დამუშავება

Hosted open-weight მოდელები იღებენ იმ შეტანას, რასაც დასახელებული მოდელი იღებს. სურათს, რომელიც მხოლოდ ტექსტურ id-ზე გაიგზავნა, პასუხობს 400 და <id> does not accept image input. response_format id-ზე სტრუქტურირებული შედეგის გარეშე პასუხობს 400-ით. GET /v1/models თითოეული id-ისთვის აჩვენებს capabilities.vision-ს, response_format-სა და json_schema-ს. სურათები და ფაილები

არასტრიმული პასუხები ატარებენ მსჯელობის ტექსტს: reasoning_content /v1/chat/completions-ის შეტყობინებაზე და thinking ბლოკი ტექსტის წინ /v1/messages-ზე. მსჯელობის effort

Hosted open-weight მოდელებს ახალი ფასები აქვთ, $0.50-დან 1M შემავალ ტოკენზე და $2.00-დან 1M გამომავალ ტოკენზე. მოდელები და ფასები

Hosted 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 ველი ყველა endpoint-ზე გამოქვეყნებული id-ია. Responses ობიექტი ატარებს model-სა და created_at-ს.

GET /v1/models თითოეული მოდელის კონტექსტის ფანჯარას აჩვენებს. მოდელები და ფასები

Hosted open-weight მოდელები პასუხობენ /v1/messages-სა და /v1/responses-ზეც, არა მხოლოდ /v1/chat/completions-ზე, თქვენი system prompt-ითა და ინსტრუმენტების გამოძახებებით. /v1/messages იღებს thinking-ს და reasoning_effort მოთხოვნის ველია. მოდელები და ფასები

შეცდომის body-ები /v1-ზე SDK-ების ფორმებს მიჰყვება: error ობიექტი type-ითა და message-ით OpenAI-ის ფორმატის endpoint-ებზე და იგივე ობიექტი {"type": "error"}-ის შიგნით /v1/messages-ზე. შეცდომების დამუშავება

Keep-alive ღია სტრიმებზე ყოველ 15 წამში: კომენტარის ხაზი : ping /v1/chat/completions-ზე, event: ping /v1/messages-ზე. სტრიმინგი

ინსტრუმენტის გამოძახების id-ები იწყება 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

Responses სტრიმის response.completed მოვლენა ატარებს 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. მოდელები და ფასები

ახალი მოდელი shannon-3. მოდელები და ფასები

/v1/chat/completions-ის სტრიმები მსჯელობას ატარებენ როგორც delta.reasoning_content. მსჯელობის effort

max_tokens რჩება 1-დან 65,536-მდე დიაპაზონში. ამ დიაპაზონს გარეთ მნიშვნელობა უახლოეს ბოლოზე გადაინაცვლებს და არ უარყოფა. Chat Completions

shannon-coder-1 ითვლება გამოძახებებით გეგმის მიხედვით /v1/chat/completions-სა და /v1/messages-ზე. როცა ფანჯრის გამოძახებები ამოიწურება, პასუხია 429 შეტყობინებით Shannon Coder call quota reached. CLI ინსტრუმენტები კოდირებისთვის

საუბარს, რომელიც კონტექსტის ფანჯარაზე დიდია, პასუხობს 400, ტიპი invalid_request_error და კოდი context_length_exceeded. სტრიმის შიგნით შეცდომა error მოვლენის სახით მოდის და არა პასუხის ტექსტად. CLI ინსტრუმენტები კოდირებისთვის

/v1 endpoint-ები: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses და GET /v1/models. სწორედ მათ იძახებენ OpenAI-სა და Anthropic-ის SDK-ები, Claude Code და Codex CLI. მიმოხილვა

ინსტრუმენტების გამოძახება tools-ით /v1/chat/completions-სა და /v1/messages-ზე, სტრუქტურირებული შედეგი response_format-ით და system სტრიქონის ან ტექსტური ბლოკების სახით /v1/messages-ზე. ფუნქციის გამოძახება

მოდელის id-ები shannon-1.6-pro, shannon-2-lite, shannon-2-pro და shannon-coder-1, shannon-1.6-lite-ის გვერდით. მოდელები და ფასები

API-ს პირველი გამოშვება: ჩატი OpenAI-ს ფორმატში და Anthropic-ის ფორმატში და Responses endpoint, თითოეული გამოიძახება API გასაღებით, რომელიც sk--ით იწყება. ავთენტიკაცია