Хязгаар ба үлдэгдэл
Хүсэлт бүрт тэгш үйлчилнэ. Хурдны түвшин байхгүй. Тусдаа API квот байхгүй. Та токенуудынхаа төлбөрийг аль хэдийн төлсөн — хүссэн хурдаараа ашиглаарай.
Энэ хуудас таны үлдэгдэл юунаас бүрдэхийг, нэг хүсэлт юу нөөцөлж, хичнээн зардалтайг, хэдэн хүсэлт илгээж болохыг, мөн нэг хүсэлтэд тохиолдох цөөн хязгаарыг тайлбарлана.
- 1M токен үлдэгдлийн үнэ цэн
- $5.00
- өдрийн эрх шинэчлэгдэнэ
- 00:00 UTC
- flood protection, бүртгэл тутамд
- 120 хүсэлт / мин
Хүсэлтэд хэрхэн үйлчилдэг
- Хурдны түвшин байхгүй — Хүсэлт хэр хурдан ирж болохыг нэг дүрэм хязгаарлах бөгөөд бүртгэл, төлөвлөгөө бүрт ижил: минутад 120 хүсэлт. Минут тутмын токены хязгаар байхгүй.
- Тусдаа API квот байхгүй — API чатын ижил үлдэгдлийг зарцуулна. Төлөвлөгөө нь өнөөдрийн эрхийн хэмжээг тогтооно. Хүсэлтийн хурдыг тогтоодоггүй.
- Хүссэн хурдаараа — Зэрэг илгээсэн хүсэлтийг хүлээн авч, дараалалд хүлээлгэнэ. Зэрэгцээ гэсэн шалтгаанаар татгалзахгүй.
Таны үлдэгдэл
Таны үлдэгдэл токеноор тоологдоно. 1,000,000 токен үлдэгдэл нь $5.00-тэй тэнцэх бөгөөд Models & pricing хуудасны үнэ бүр энэ үнэлгээтэй харьцуулсан хувь юм.
Үлдэгдэл ямар ч мөчид хоёр хэсгийн нийлбэр байна.
- Өнөөдрийн төлөвлөгөөний эрх — Таны төлөвлөгөөний тогтоосон токены тоо. Өдөр бүр 00:00 UTC-д шинэчлэгдэнэ. Өдрийн эцэст үлдсэн хэсэг дараа өдөрт шилжихгүй.
- Худалдаж авсан зээл — Багц болгон худалдаж авсан токен. Зээл дуусах хугацаагүй бөгөөд Free зэрэг бүх төлөвлөгөөнд ажиллана.
| Төлөвлөгөө | Өдөрт токен | Үнэ цэн |
|---|---|---|
| Free | 30,000 | $0.15 |
| Plus | 80,000 | $0.40 |
| Standard | 265,000 | $1.325 |
| Pro | 665,000 | $3.325 |
- Зарцуулах дараалал — Хүсэлт бүр эхлээд өнөөдрийн төлөвлөгөөний эрхийг зарцуулна. Худалдаж авсан зээлийг тэр өдөр эрхээс давсан хэсэгт л ашиглана.
- Чат ба API хуваалцана — Бүртгэл бүрт нэг үлдэгдэл байна. API түлхүүр өөрийг нь эзэмшдэг бүртгэлийн үлдэгдлээс чатын адил үнээр зарцуулна.
- Багцууд — Зээлийг 1,000,000 ($5.00), 2,000,000 ($10.00), 5,000,000 ($25.00) токены багцаар, эсвэл 1,000,000-ээс 100,000,000 токен хүртэл өөрийн сонгосон хэмжээгээр 1,000,000-д $5.00 үнээр зарна.
Зээл цэнэглэх Төлөвлөлт өөрчлөх
Хүсэлт юу нөөцөлж, хичнээн зардалтай
- Нөөцлөх — Хүсэлт ирэхэд гаралтын төсвөө үлдэгдлээс нөөцөлнө:
/v1/chat/completionsба/v1/messagesдээрmax_tokens,/v1/responsesдээрmax_output_tokens./v1/chat/completionsмөнmax_completion_tokens-ийг уншина. Үндсэн утга 4,096, муж 1-ээс 65,536. - Хүлээн авах — Нөөцлөлт үлдсэн үлдэгдэлд багтсан тохиолдолд л хүсэлтийг хүлээн авна. Үлдэгдэл тэгээс их боловч гаралтын төсвөөс бага бол
Quota exceededхариу гарна. Үлдсэнийг ашиглахын тулд багаmax_tokensилгээнэ үү. - Тооцоо хийх — Хариу дуусахад нөөцлөлтийг жинхэнэ тооцоогоор сольно. Тооцоо нөөцлөлтөөс бага ч, их ч байж болно.
- Буцаах — Алдааны статусаар дууссан хүсэлт нөөцлөлтөө бүрэн буцаана.
Жинхэнэ тооцоо загварын гэр бүлээс хамаарна.
| Загварууд | Юу тооцогдох |
|---|---|
| Shannon загварууд | usage.total_tokens-ийг загварын 1M тутмын үнээр. Оролт ба гаралт нэг үнэтэй. |
| Hosted open-weight загварууд | Кэшлэгдээгүй оролтыг оролтын үнээр, кэшлэгдсэн оролтыг кэшийн үнээр, гаралтыг гаралтын үнээр. |
USD дүнг таны токен үлдэгдлээс 1,000,000 тутамд $5.00-ээр авч, бүхэл токен болгон бөөрөнхийлнө.
POST /v1/tokenize эсвэл POST /v1/messages/count_tokens-оор токен тоолох нь үнэгүй бөгөөд юу ч нөөцлөхгүй. Токен тоолох
Үлдэгдэл ба хэрэглээг хаанаас харах
Keys & usage хуудас таны яг одоо зарцуулж болох хэмжээ, өнөөдрийн төлөвлөгөөний эрх, худалдаж авсан зээл, сүүлийн 30 хоногийн API зардлыг харуулна. Түүний доор таны түлхүүрийн хийсэн хүсэлт бүрийг жагсаана: цаг, endpoint, загвар, кэшлэгдсэн оролт, тооцсон токен, зардал. Түлхүүр ба хэрэглээ
Хариу бүр тухайн дуудлагын токены тоог агуулсан usage объекттой.
| Endpoint | Usage-ийн талбарууд | Hosted open-weight загваруудын нэмдэг |
|---|---|---|
/v1/chat/completions | prompt_tokens, completion_tokens, total_tokens | prompt_tokens_details.cached_tokens, completion_tokens_details.reasoning_tokens |
/v1/messages | input_tokens, output_tokens | cache_read_input_tokens, cache_creation_input_tokens |
/v1/responses | input_tokens, output_tokens, total_tokens | input_tokens_details.cached_tokens, output_tokens_details.reasoning_tokens |
usageнь загварын токены тоог агуулна. Таны үлдэгдлээс хасагдсан хэмжээ хариунд байхгүй: энэ нь Keys & usage дээрх хүсэлтийн жагсаалтын Billed tokens багана юм.- Hosted open-weight загвартай
/v1/messagesдээрinput_tokensнь оролтын кэшлэгдээгүй хэсэг,cache_read_input_tokensнь кэшлэгдсэн хэсэг,cache_creation_input_tokensнь үргэлж0. -
/v1/chat/completionsдээрх stream[DONE]-оос өмнөх сүүлийн chunk-дааusageагуулна. Дамжуулалт
Үлдэгдэл дуусахад
Нөөцлөлт нь үлдэгдэлд багтахгүй хүсэлтэд 429 статус, rate_limit_error төрөл болон доорх мессежээр хариулна. Юу ч тооцогдохгүй. Үлдэгдэл тэгээс их боловч хүсэлтийн гаралтын төсвөөс бага үед ч ижил хариу өгнө.
{
"error": {
"type": "rate_limit_error",
"message": "Quota exceeded. Upgrade your plan at shannon-ai.com/plan"
}
} {
"type": "error",
"error": {
"type": "rate_limit_error",
"message": "Quota exceeded. Upgrade your plan at shannon-ai.com/plan"
}
} /v1/responses дээр error объект code ба param-г бас агуулж болох бөгөөд хоёулаа null.
Хийж болох зүйл:
- 00:00 UTC-д төлөвлөгөөний дараагийн эрхийг хүлээнэ үү.
- Зээл цэнэглэнэ үү. Зээлийг төлөвлөгөөний эрхийн дараа зарцуулах бөгөөд дуусах хугацаагүй. Зээл цэнэглэх
- Өдрийн эрх нь илүү том төлөвлөгөөнд шилжинэ үү. Төлөвлөлт өөрчлөх
- Үлдэгдэл бага зэрэг үлдсэн бол бага
max_tokensилгээнэ үү: нөөцлөлт бага болно.
Shannon Coder дуудлагын эрх
/v1/chat/completions ба /v1/messages дээрх shannon-coder-1 нь токеноор бус дуудлагаар тоологдоно. Төлөвлөгөө бүр 4 цагийн цонх тутамд тодорхой тооны дуудлага агуулна. Нэг хүсэлт нь нэг дуудлага.
| Төлөвлөгөө | 4 цагийн цонх тутамд дуудлага |
|---|---|
| Free | 3 |
| Plus | 20 |
| Standard | 40 |
| Pro | 60 |
- Цонх 00:00, 04:00, 08:00, 12:00, 16:00, 20:00 UTC-д эхэлнэ. Цонхны эцэст үлдсэн дуудлага дараагийнх руу шилжихгүй.
- Дуудлагыг хүсэлтийг хүлээн авсан үед, загвар хариулахаас өмнө тоолно. Дараа нь амжилтгүй болсон хүсэлт ч дуудлагад тоологдоно.
- Эдгээр дуудлага токен нөөцлөхгүй, үлдэгдлээс юу ч хасахгүй. Keys & usage дээрх хүсэлтийн жагсаалт тэдгээрийн токены тоо ба жагсаасан үнээрх үнэ цэнийг харуулна.
- Эдгээр хоёр endpoint дээрх
shannon-coder-1-ийнmax_tokens-ийн үндсэн утга 65,536. - Дуудлага үлдээгүй үед хариу нь
429статус,rate_limit_errorтөрөл,Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/planмессежтэй. /v1/responsesдээрshannon-coder-1-д дуудлагын эрх байхгүй: бусад загварын адил 1M тутамд $8.00 үнээр үлдэгдлээс токеноор тооцогдоно.
Flood protection
Бүртгэл минутад 120 хүсэлт илгээж болно. Энэ нь хүсэлтийн хурдны цорын ганц хязгаар бөгөөд төлөвлөгөө бүрт ижил. Энэ нь үерийг зогсоох зорилготой, ердийн хэрэглээг удаашруулахгүй.
- Минут нь таны эхний хүсэлтээр нээгддэг 60 секундийн тогтмол цонх. Дуусахад тоолол тэгээс дахин эхэлнэ.
- Тоолол нь бүртгэл тутамд, түлхүүр эсвэл IP хаяг тутамд биш. Түлхүүр солих нь шинэ цонх нээхгүй.
- Цонх доторх 121 дэх хүсэлтэд
429статус,rate_limit_errorтөрөл,Too many requests. Retry in <N>s.мессежээр хариулна.Nнь цонх дуустал үлдсэн секунд, 1-ээс 60. - Flood protection-ийг үлдэгдлээс өмнө шалгана. Татгалзсан хүсэлт юу ч нөөцлөхгүй, үнэ гарахгүй.
{
"error": {
"type": "rate_limit_error",
"message": "Too many requests. Retry in 37s."
}
} {
"type": "error",
"error": {
"type": "rate_limit_error",
"message": "Too many requests. Retry in 37s."
}
} | Хүсэлт | Flood protection |
|---|---|
POST /v1/chat/completions, POST /v1/messages, POST /v1/responses | Тоологдоно, хүсэлт тутамд нэг. |
GET /v1/models, POST /v1/tokenize, POST /v1/messages/count_tokens | Тоологдохгүй. |
/v1/chat/completions ба /v1/messages дээрх shannon-coder-1 | Үүний оронд Shannon Coder дуудлагын эрхээр тоологдоно. |
401-ээр, эсвэл үл мэдэгдэх model-д 400-аар хариулсан хүсэлт | Тоологдохгүй. |
| Flood protection-ий татгалзсан хүсэлт | Цонхонд тоологдоно. Юу ч тооцогдохгүй. |
Зэрэгцээ хүсэлт
Бүртгэл зэрэг хэчнээн хүсэлт нээлттэй байлгахад хязгаар байхгүй, хүсэлтийг зэрэг илгээсэнд алдаа гарахгүй. Шууд эхэлж чадахгүй хүсэлтүүд дараалалд хүлээж, ээлж ээлжээрээ хариулагдана.
- Өмнөх хүсэлт дууссан эсэхээс үл хамааран хүсэлт бүр ирэх үедээ минутад 120-ийн тоололд орно.
- Хүсэлт бүр дуустал өөрийн нөөцлөлтийг барина. Үндсэн гаралтын төсөвтэй хорин нээлттэй хүсэлт 20 × 4,096 = 81,920 токен үлдэгдэл барина. Нөөцлөлтүүдийн нийлбэр таны үлдэгдлээс их бол дууссан дуудлагууд бага зардалтай байх байсан ч дараагийн хүсэлт
Quota exceededхариу авна. Багаmax_tokensбага барина. - Stream хийгээгүй хүсэлт хариу бүрэн болтол юу ч илгээхгүй, тиймээс клиентдээ хүлээлтийг хамарсан timeout өгнө үү. Stream хүлээх хугацаандаа холболтыг нээлттэй байлгана. Дамжуулалт
Нэг хүсэлтийн хязгаар
| Хязгаар | Утга | Хамаарах газар | Хязгаарт хүрэхэд |
|---|---|---|---|
| Хүсэлтийн body | 32 MiB (33,554,432 байт) | Бүх endpoint | Статус 413, төрөл invalid_request_error. |
Гаралтын төсөв: max_tokens, max_completion_tokens, max_output_tokens | 1-ээс 65,536. Үндсэн утга 4,096; /v1/chat/completions ба /v1/messages дээрх shannon-coder-1-д үндсэн утга 65,536. | Бүх загвар, үлдэгдлээс нөөцлөх хэмжээ болгон. Хариултын уртын хязгаар болгон: hosted open-weight загварууд, shannon-1.6-lite, shannon-1.6-pro ба shannon-coder-1. | Мужаас гарсан утгыг мужийн хамгийн ойрын захад шилжүүлнэ. Алдаа гарахгүй. |
Зогсоох дараалал: stop, stop_sequences | 4 string | Hosted open-weight загварууд | Хоосон биш эхний 4 string-ийг ашиглана. |
| URL-ээр өгсөн зураг эсвэл файл | 8 MiB, 20 секундэд уншина, дээд тал нь 5 дахин чиглүүлэлт, нийтийн http эсвэл https хаяг | Зураг эсвэл файл авдаг бүх endpoint | Хүсэлтэд тэр хэсэггүйгээр хариулна. Алдаа гарахгүй. |
| Шууд илгээсэн зураг эсвэл файл (base64) | Өөрийн хязгаар байхгүй. 32 MiB-ийн хүсэлтийн body-д тоологдоно. | Зураг эсвэл файл авдаг бүх endpoint | Бүх хүсэлтэд статус 413. |
POST /v1/tokenize-ийн text | 4,000,000 байт | /v1/tokenize | Статус 413, төрөл invalid_request_error, мессеж text too long. |
POST /v1/tokenize-ийн messages ба POST /v1/messages/count_tokens-ийн body | 32 MiB-ийн хүсэлтийн body | Тоолох хоёр endpoint | Статус 413. |
| Контекст цонх | Загвар тус бүрд: GET /v1/models дэх context_window | Бүх загвар | Хэт урт харилцан ярианд юу болох нь загвараас хамаарна. Загвар ба үнэ |
Вэб хайлт (web_search: true) | Төлөвлөгөө ба өдөр тутамд: Free 3, Plus 30, Standard 50, Pro 60. Хайлт нь үр дүн олсон хүсэлтэд нэг хайлт гэж тоологдоно. | web_search: true тохируулсан хүсэлт | Үлдээгүй үед хүсэлтэд хайлтгүйгээр хариулна. Алдаа гарахгүй. Вэб хайлт |
Алдаа
Энэ хуудасны хариунууд. /v1/messages дээр ижил error объект {"type": "error", "error": {…}} гэж ороогдоно.
| Төлөв | Төрөл | Мессеж | Хэзээ, юу хийх |
|---|---|---|---|
429 | rate_limit_error | Quota exceeded. Upgrade your plan at shannon-ai.com/plan | Хүсэлтийн нөөцлөлт таны үлдэгдэлд багтахгүй байна. 00:00 UTC-г хүлээх, зээл цэнэглэх, төлөвлөгөө солих, эсвэл бага max_tokens илгээнэ үү. |
429 | rate_limit_error | Too many requests. Retry in <N>s. | Одоогийн минутад 120-оос олон хүсэлт. N секунд хүлээгээд дахин илгээнэ үү. |
429 | rate_limit_error | Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan | Одоогийн 4 цагийн цонхны Shannon Coder дуудлага дууссан. |
429 | rate_limit_error | Shannon routes are temporarily busy. Please retry. | Загвар яг одоо хүсэлтийг авч чадахгүй байна. Богино завсарлагааны дараа дахин илгээнэ үү. |
503 | api_error | Could not verify your quota right now. Please retry. | Таны үлдэгдлийг унших боломжгүй байсан. Юу ч тооцогдоогүй; хүсэлтийг дахин илгээнэ үү. Shannon загвартай /v1/responses дээр статус 500. |
413 | invalid_request_error | Хүсэлтийн body 32 MiB-ээс том. OpenAI форматын endpoint-ууд дээр error объект code: "request_too_large" агуулна. | |
413 | invalid_request_error | text too long | POST /v1/tokenize-ийн text 4,000,000 байтаас урт. |