Обзор

Endpoint'тер

Ар бир endpoint бир негизги URL астында жана HTTPS аркылуу тейленет.

https://api.shannon-ai.com

Текст чыгарган үч endpoint бир эле моделдерге жетет. Кодуңуз буга чейин колдонгон форматтагысын тандаңыз.

Сурамдын негиздери

• Ар бир POST денеси 32 MiB'ге чейинки бир JSON объекти.
• API билбеген талаа ката чыгарбайт жана эч таасир этпейт. Башка провайдер үчүн жазылган сурам ашыкча талаа үчүн ишке ашпай калбайт.
• JSON түрү туура эмес белгилүү талаа же милдеттүү талаа жоктугу 422 менен жооп алат. Жарактуу JSON эмес дене 400 менен жооп алат.
• model — Models & pricing бетиндеги id'лердин бири. Чоң жана кичине тамга маанилүү эмес.

Жооп — JSON, же сурам stream'ди true койгондо server-sent events стриму. Ар бир endpoint өз форматында жооп берет. Ар бир жоопто x-request-id башы бар.

Сурам эмнеден өтөт

Модель иштегенге чейин сурам бекитилген тартипте текшерилет. Ишке ашпаган биринчи текшерүү жооп берет, ошондуктан 401 дене жөнүндө азырынча эч нерсе айтпайт.

Катанын формасы

Ката — type жана message камтыган error бар JSON объекти. /v1/messages аны Anthropic SDK'лары күткөндөй ороп берет; башка ар бир жол OpenAI формасын колдонот.

{
  "error": {
    "type": "invalid_request_error",
    "message": "unknown model: gpt-4o"
  }
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "unknown model: gpt-4o"
  }
}

• type жана message окуңуз. code жана param кээ бир каталарда гана бар: аларды милдеттүү эмес деп эсептеңиз. param ар дайым null.
• Стрим башталгандан кийин статус буга чейин эле 200. Ошондо ката стримдин ичинде ката фрейми катары келет.
• Ар бир ката жообу x-request-id башын алып жүрөт.

Ката иштетүү

Эсептөө жана баланс

• Аккаунтка бир баланс, жана чат менен API аны бөлүшөт: адегенде бүгүнкү план үлүшү, андан кийин сатып алынган кредит. API'нын өз квотасы жок.
• Сурам өзүнүн чыгыш бюджетин (max_tokens, стандарттуу 4,096) резервдейт, андан кийин чындыгында колдонулган токендер үчүн модельдин баасы боюнча эсептелет.
• Ар бир жооп токен сандарын usage ичинде билдирет. Keys & usage бети балансты жана ар бир сурам канчага турганын көрсөтөт.
• Ар бир сурам бирдей тейленет. Сурам ылдамдыгына жалгыз чек — flood protection: аккаунтка мүнөтүнө 120 сурам. Параллель жөнөтүлгөн сурамдар кезекте турат.

Чектөөлөр жана баланс Моделдер жана баалар Ачкычтар жана колдонуу

Моделге көз каранды талаалар

Ар бир модель бир эле сурамды кабыл алат. Бир нече талаа кээ бир моделдерде гана иштейт; таблица кайсыларда экенин атайт. Endpoint беттери ар бир талааны тизмелейт.

Chat Completions

OpenAI SDK'сынан келгенде

• Негизги URL'ди https://api.shannon-ai.com/v1 кылып, ал эми ачкычты Shannon ачкычыңыз кылып коюңуз. Ошондо Chat Completions жана Responses чалуулары SDK менен өзгөрүүсүз иштейт.
• model Shannon id болушу керек. gpt-4o сыяктуу башка провайдердин модель аты 400 жана unknown model менен жооп алат.
• Reasoning өзүнчө талаада келет: билдирүүдө жана стрим дельталарында content жанында reasoning_content.
• Стрим акыркы чанкында ар дайым usage'ти finish_reason менен бирге алып келет.
• Стримдеги курал чалуусу arguments сапты толук камтыган бир чанк катары келет.
• Жоопто бир тандоо бар.
• Жогорудагы таблицада жок OpenAI API жолдору, мисалы /v1/embeddings, 404 менен жооп алат.

Anthropic SDK'сынан келгенде

• Негизги URL'ди https://api.shannon-ai.com кылып, /v1 жок, ал эми ачкычты Shannon ачкычыңыз кылып коюңуз. SDK аны x-api-key катары жөнөтөт.
• model Shannon id болушу керек.
• Бул API'да max_tokens милдеттүү эмес. Анын стандарттуу мааниси 4,096.
• Жооп thinking, text жана tool_use түрүндөгү мазмун блокторун камтыйт. Биринчи блок ар дайым текст боло бербейт: блокторду type боюнча тандаңыз.
• stop_reason — end_turn же tool_use. Shannon моделинин стриму max_tokens менен да аяктай алат.
• anthropic-version жана anthropic-beta кабыл алынат, ошондуктан SDK өзгөрүүсүз иштейт. Сурамга алар керек эмес.
• /v1/messages боюнча каталар Anthropic формасында: {"type": "error", "error": {…}}.

Бул форматтарда сүйлөгөн коддоо куралдары ошондой эле орнотулат: негизги URL, ачкыч жана модель катары Shannon id. Код жазуу үчүн CLI куралдары