Тағйирот
Навсозиҳо ва беҳбудҳои охирини Shannon API.
Ин саҳифа тағйиротеро номбар мекунад, ки шумо ҳамчун даъваткунандаи API мушоҳида карда метавонед: endpoint-ҳо, майдонҳо ва моделҳои нав, рафтори тағйирёфта ва ислоҳҳо. Сабтҳои навтарин аввал меоянд. Ҳар сабт санаи тағйиротро дорад.
Сабти бо Тағйироти вайронкунанда нишондодашуда метавонад натиҷаи дархостеро, ки пештар кор мекард, тағйир диҳад. API як версия дорад, /v1, бинобар ин тағйирот аз рӯи сана номбар мешаванд, на аз рӯи рақами версия.
- Нав
Дархости дорои
web_search: trueманбаъҳои худро номбар мекунад:sourcesдар/v1/chat/completionsва/v1/messagesнатиҷаҳоеро, ки ба модел дода шудаанд, рӯйхат мекунад, ваannotationsдар/v1/chat/completionsҷойеро, ки ҷавоб ҳар кадомро иқтибос мекунад, қайд мекунад. Ҷустуҷӯи веб
- Нав
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: ҳисоби ройгони токенҳо барои моделҳои open-weight-и хостшуда. Ҳисоби токенҳо - Нав
Кэшкунии prompt дар моделҳои open-weight-и хостшуда. Вуруди кэшшуда бо 25% нархи вуруд ҳисоб карда мешавад ва дар
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-ро ҳисобот медиҳад. Кэшизатсозии prompt - Ислоҳ
Моделҳои open-weight-и хостшуда:
tool_choice-и маҷбурӣ (requiredё функсияи номбаршуда) даъвати абзор медиҳад. Даъвати функсия - Ислоҳ
Моделҳои open-weight-и хостшуда паёми
system-ро, ки аввалин паёми гуфтугӯ нест, қабул мекунанд.
- Нав
API ҳамчун хидмати onion-и Tor ва дар суроғаи I2P дастрас аст. Ҷавобҳои
api.shannon-ai.comду суроғаро дар сарлавҳаҳоиOnion-LocationваX-I2P-Locationдоранд. Endpointҳои рамзгузоришуда, Tor ва I2P
- Нав
Моделҳои нав
shannon-3.1ваshannon-3.1-pro, киGET /v1/modelsонҳоро номбар мекунад. Моделҳо ва нархҳо - Тағйирёфта
Дархости streaming, ки клиенташ қатъ мешавад, то охир иҷро мешавад ва ҳисоб карда мешавад. Пештар ҷавоб ҳангоми қатъ шудан қатъ мешуд.
- Ислоҳ
Дархостҳо ба
/v1/responsesдар ҷурнали usage пайдо мешаванд.
- Нав
Моделҳои 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 - Нав
Ҷурнали usage арзишро бо USD барои ҳар даъват ва ҳамчун ҷамъ нишон медиҳад.
- Тағйироти вайронкунанда
Ба қимати
model, ки id-и нашршуда нест, дар ҳар се endpoint бо400, навъиinvalid_request_errorва паёмиunknown model: <id>ҷавоб дода мешавад. Пештар ба чунин дархостshannon-1.6-liteҷавоб медод. Моделҳо ва нархҳо - Тағйироти вайронкунанда
/v1танҳо калиди API-ро қабул мекунад. Cookie-и воридшавии вебсайт дар он ҷо хонда намешавад. Аутентификатсия - Тағйирёфта
Ҳифз аз дархостҳои аз ҳад зиёд: 120 дархост дар як дақиқа барои ҳар аккаунт дар се endpoint-и тавлид. Маҳдудиятҳо ва баланс
- Беҳбуд
Вақте ки модел ҷавоб дода наметавонад, хатогӣ паёми собити
The model backend failed to answer. Please retry.-ро дорад. Ба санҷиши балансе, ки гузаронда намешавад, бо503ва навъиapi_errorҷавоб дода мешавад. Идораи хатогиҳо - Ислоҳ
Дархости бе streaming, ки ноком мешавад, захираи худро ба балансатон бармегардонад.
- Нав
GET /v1/modelsбарои ҳар моделcapabilities.reasoning_effort-ро ҳисобот медиҳад. Сатҳи кӯшиши reasoning - Беҳбуд
Моделҳои open-weight-и хостшуда: дархости бе streaming, ки ҷавоб намегирад, бо
504ва навъиapi_errorтамом мешавад. Натиҷаи холӣ502аст. Идораи хатогиҳо
- Тағйироти вайронкунанда
Моделҳои open-weight-и хостшуда вуруди ҳамон моделеро қабул мекунанд, ки ном дорад. Ба тасвире, ки ба id-и танҳо матнӣ фиристода шудааст, бо
400ва<id> does not accept image inputҷавоб дода мешавад. Баresponse_formatдар id бе баромади сохторӣ бо400ҷавоб дода мешавад.GET /v1/modelsбарои ҳар idcapabilities.vision,response_formatваjson_schema-ро ҳисобот медиҳад. Тасвирҳо ва файлҳо - Ислоҳ
Ҷавобҳои бе streaming матни reasoning-ро доранд:
reasoning_contentдар паёми/v1/chat/completionsва блокиthinkingпеш аз матн дар/v1/messages. Сатҳи кӯшиши reasoning - Тағйирёфта
Моделҳои open-weight-и хостшуда нархҳои нав доранд, аз $0.50 барои 1M токени вуруд ва $2.00 барои 1M токени баромад. Моделҳо ва нархҳо
- Тағйирёфта
Моделҳои 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/responsesreasoning-и моделҳои Shannon-ро бармегардонад: ҷузъи баромадиreasoningпеш аз ҷузъиmessageва рӯйдодҳои ҷараёниresponse.reasoning_summary_text.deltaваresponse.reasoning_summary_text.done. Responses API - Ислоҳ
Майдони
model-и ҷавоб дар ҳар endpoint id-и нашршуда аст. Объекти Responsesmodelваcreated_at-ро дорад. - Беҳбуд
GET /v1/modelsравзанаи контексти ҳар моделро ҳисобот медиҳад. Моделҳо ва нархҳо
- Нав
Моделҳои open-weight-и хостшуда дар
/v1/messagesва/v1/responsesҳамчунин дар/v1/chat/completionsҷавоб медиҳанд, бо system prompt ва даъватҳои абзори шумо./v1/messagesthinking-ро қабул мекунад ваreasoning_effortмайдони дархост аст. Моделҳо ва нархҳо - Беҳбуд
Баданҳои хатогӣ дар
/v1шаклҳои SDK-ро пайравӣ мекунанд: объектиerrorбоtypeваmessageдар endpoint-ҳои формати OpenAI ва ҳамон объект дар дохили{"type": "error"}дар/v1/messages. Идораи хатогиҳо - Нав
Keep-alive дар ҷараёнҳои кушода ҳар 15 сония: хати эзоҳи
: pingдар/v1/chat/completions,event: pingдар/v1/messages. Стриминг - Тағйирёфта
Id-ҳои даъвати абзор дар
/v1/chat/completionsва/v1/responsesбоcall_ва дар/v1/messagesбоtoolu_оғоз мешаванд. Даъвати функсия - Тағйироти вайронкунанда
/v1/responses:streamба таври пешфарзfalseаст. Responses API - Нав
max_completion_tokensдар/v1/chat/completionsҳамчун номи дигариmax_tokensқабул мешавад. Chat Completions - Ислоҳ
Рӯйдоди
response.completed-и ҷараёни Responses массивиoutput-ро дорад. Responses API - Нав
Сабтҳои
GET /v1/modelsdisplay_name,context_window,max_output_tokens,pricing,capabilitiesваendpoints-ро доранд. Моделҳо ва нархҳо - Нав
Ҳар ҷавоб
x-request-id-ро дорад ва қимате, ки шумо мефиристед, баргардонда мешавад. Баданҳои дархост то 32 MiB шуда метавонанд. - Нав
Калидро бе додани калиди нав бекор кардан мумкин аст. Ҷурнали usage саҳифабандӣ шудааст.
- Нав
Тасвирҳо ва ҳуҷҷатҳо дар дархостҳо: қисмҳои
image_urlдар/v1/chat/completions, блокҳоиimage,documentваfileдар/v1/messages, қисмҳоиinput_imageдар/v1/responses. Тасвирҳо ва файлҳо - Нав
Модели нав
shannon-3-pro. Моделҳо ва нархҳо
- Нав
Модели нав
shannon-3. Моделҳо ва нархҳо - Нав
Ҷараёнҳо дар
/v1/chat/completionsreasoning-ро ҳамчунdelta.reasoning_contentмебаранд. Сатҳи кӯшиши reasoning
- Тағйирёфта
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ҷавоб дода мешавад. Хатогӣ дар дохили ҷараён ҳамчун рӯйдоди хатогӣ меояд, на ҳамчун матн дар ҷавоб. Абзорҳои CLI барои барномасозӣ
- Нав
Endpoint-ҳои
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesваGET /v1/models. Инҳо endpoint-ҳое мебошанд, ки SDK-ҳои OpenAI ва Anthropic, 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 ва endpoint-и Responses, ки ҳар кадомаш бо калиди API, ки бо
sk-оғоз мешавад, даъват карда мешавад. Аутентификатсия