سنوور و باڵانس
هەموو داواکارییەک یەکسان خزمەت دەکرێت. ئاستی ڕێژە نییە. quota ی API ی جیاواز نییە. تۆکنەکانتت پێشتر کڕیوە — بە هەر خێراییەک دەتەوێت بەکاریان بهێنە.
ئەم لاپەڕەیە ڕوون دەکاتەوە باڵانسەکەت لە چی پێکهاتووە، یەک داواکاری چی ڕادەگرێت و چی تێدەچێت، چەند داواکاری دەتوانیت بنێریت، و ئەو چەند سنوورەی یەک داواکاری دەتوانێت تووشیان بێت.
- بەهای 1M تۆکنی باڵانس
- $5.00
- ڕێپێدانی ڕۆژانە نوێ دەبێتەوە
- 00:00 UTC
- flood protection، بۆ هەر هەژمارێک
- 120 داواکاری / خولەک
داواکارییەکان چۆن خزمەت دەکرێن
- ئاستی ڕێژە نییە — یەک یاسا سنووردار دەکات داواکارییەکان چەند خێرا بگەن، و بۆ هەموو هەژمار و هەموو پلانێک وەک یەکە: 120 داواکاری لە خولەکێکدا. هیچ سنوورێک نییە بۆ تۆکن لە خولەکێکدا.
- quota ی API ی جیاواز نییە — API هەمان باڵانسی chat خەرج دەکات. پلان قەبارەی ڕێپێدانی ئەمڕۆ دیاری دەکات. ڕێژەی داواکاری دیاری ناکات.
- بە هەر خێراییەک دەتەوێت — ئەو داواکارییانەی بە پاڕالێل دەنێردرێن وەردەگیرێن و لە ڕیزدا چاوەڕێ دەکەن. بەهۆی پاڕالێلبوونەوە ڕەت ناکرێنەوە.
باڵانسەکەت
باڵانسەکەت بە تۆکن هەژمار دەکرێت. 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 |
- ڕیزبەندی خەرجکردن — هەر داواکارییەک سەرەتا ڕێپێدانی پلانی ئەمڕۆ خەرج دەکات. کرێدیتی کڕدراو تەنها بۆ ئەوە بەکاردێت کە لەو ڕۆژەدا لە ڕێپێدانەکە تێدەپەڕێت.
- Chat و API هاوبەشن تێیدا — بۆ هەر هەژمارێک یەک باڵانس هەیە. کلیلی API لە باڵانسی ئەو هەژمارە خەرج دەکات کە خاوەنیەتی، بە هەمان نرخی chat.
- پاکێجەکان — کرێدیت بە پاکێجی 1,000,000 ($5.00)، 2,000,000 ($10.00) و 5,000,000 ($25.00) تۆکن دەفرۆشرێت، یان بە بڕێک بە هەڵبژاردنی خۆت لە 1,000,000 تا 100,000,000 تۆکن بە $5.00 بۆ هەر 1,000,000.
داواکارییەک چی ڕادەگرێت و چی تێدەچێت
- ڕاگرتن — کاتێک داواکارییەک دەگات بودجەی output ی خۆی لە باڵانسەکەت ڕادەگرێت:
max_tokensلەسەر/v1/chat/completionsو/v1/messages،max_output_tokensلەسەر/v1/responses./v1/chat/completionsmax_completion_tokensیش دەخوێنێتەوە. بنەڕەتی 4,096 ە و ڕێژەکە 1 تا 65,536 ە. - وەرگرتن — داواکارییەکە تەنها ئەگەر وەرگیرێت کە ڕاگرتنەکە لەگەڵ ماوەی باڵانسەکەت بگونجێت. باڵانسێک کە لە سفر زیاترە بەڵام لە بودجەی output کەمترە وەڵامی
Quota exceededوەردەگرێت.max_tokensێکی بچووکتر بنێرە بۆ بەکارهێنانی ئەوەی ماوەتەوە. - یەکلاکردنەوە — کاتێک وەڵامەکە تەواو بوو، ڕاگرتنەکە بە نرخی ڕاستەقینە دەگۆڕدرێت. نرخەکە دەکرێت لە ڕاگرتنەکە کەمتر یان زیاتر بێت.
- گەڕاندنەوە — داواکارییەک کە بە status ی هەڵە کۆتایی بێت ڕاگرتنەکەی بە تەواوی دەگەڕێنێتەوە.
نرخی ڕاستەقینە بەپێی بنەماڵەی مۆدێلەکەیە.
| مۆدێلەکان | چی نرخ دەگیرێت |
|---|---|
| مۆدێلەکانی Shannon | usage.total_tokens بە نرخی مۆدێلەکە بۆ هەر 1M. Input و output یەک نرخیان هەیە. |
| مۆدێلە open-weight ـە میوانداریکراوەکان | input ی نەکەشراو بە نرخی input، input ی کەشراو بە نرخی کەشراو، output بە نرخی output. |
بڕی USD لە باڵانسەکەت دەگیرێت بە تۆکن بە $5.00 بۆ هەر 1,000,000، بۆ تۆکنێکی تەواو خر دەکرێتەوە.
هەژمارکردنی تۆکن بە POST /v1/tokenize یان POST /v1/messages/count_tokens بێبەرامبەرە و هیچ ڕاناگرێت. هەژمارکردنی تۆکن
لە کوێ باڵانس و بەکارهێنان ببینیت
لاپەڕەی Keys & usage نیشانت دەدات ئێستا چەندت دەتوانیت خەرج بکەیت، ڕێپێدانی پلانی ئەمڕۆ، کرێدیتی کڕدراوت و خەرجی API ی 30 ڕۆژی ڕابردوو. لە خوارەوەی ئەوە هەموو داواکارییەک لیست دەکات کە کلیلەکەت کردوویەتی: کات، endpoint، مۆدێل، input ی کەشراو، تۆکنی نرخگیراو و تێچوو. Keys & usage
هەر وەڵامێک ئۆبجێکتی usage یش هەڵدەگرێت کە ژمارەی تۆکنەکانی ئەو بانگکردنە تێدایە.
| Endpoint | بوارەکانی usage | لەلایەن مۆدێلە 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.- لەسەر
/v1/messagesلەگەڵ مۆدێلێکی open-weight ی میوانداریکراو،input_tokensبەشی نەکەشراوی input ە،cache_read_input_tokensبەشی کەشراوە وcache_creation_input_tokensهەمیشە0ە. - stream لەسەر
/v1/chat/completionsusageلە دوایین chunk ی پێش[DONE]هەڵدەگرێت. Streaming
کاتێک باڵانس تەواو دەبێت
داواکارییەک کە ڕاگرتنەکەی لە باڵانسەکەت نەگونجێت بە status ی 429، جۆری rate_limit_error و ئەو پەیامەی خوارەوە وەڵام دەدرێتەوە. هیچ شتێک نرخ ناگیرێت. هەمان وەڵام دەنێردرێت کاتێک باڵانس لە سفر زیاترە بەڵام لە بودجەی output ی داواکارییەکە کەمترە.
{
"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
shannon-coder-1 لەسەر /v1/chat/completions و /v1/messages بە بانگکردن هەژمار دەکرێت، نەک بە تۆکن. هەر پلانێک ژمارەیەک بانگکردن بۆ هەر پەنجەرەیەکی 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 ژمارەی تۆکنەکانیان و بەهاکەیان بە نرخی لیستکراو نیشان دەدات.
max_tokensی بنەڕەتییshannon-coder-1لەسەر ئەم دوو endpoint ـە 65,536 ە.- کاتێک هیچ بانگکردنێک نەمێنێت وەڵامەکە status ی
429ە، جۆریrate_limit_error، پەیامیShannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan. - لەسەر
/v1/responses،shannon-coder-1ڕێپێدانی بانگکردنی نییە: بە تۆکن لە باڵانسەکەت نرخ دەگیرێت بە $8.00 بۆ هەر 1M، وەک هەموو مۆدێلێکی دیکە.
Flood protection
هەژمارێک دەتوانێت 120 داواکاری لە خولەکێکدا بنێرێت. ئەوە تەنها سنووری ڕێژەی داواکارییە، و لەسەر هەموو پلانێک وەک یەکە. بۆ ڕێگرتن لە flood دانراوە، نەک بۆ خاوکردنەوەی بەکارهێنانی ئاسایی.
- خولەکەکە پەنجەرەیەکی جێگیری 60 چرکەییە کە بە یەکەم داواکاریت دەکرێتەوە. کاتێک کۆتایی دێت، ژماردنەکە لە سفرەوە دەست پێدەکاتەوە.
- ژماردنەکە بۆ هەر هەژمارێکە، نەک بۆ هەر کلیلێک و نەک بۆ هەر ناونیشانی IP ێک. گۆڕینی کلیل پەنجەرەیەکی نوێ ناکاتەوە.
- داواکاری 121 لەناو پەنجەرەیەکدا بە status ی
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 | هەژمار ناکرێت. |
shannon-coder-1 لەسەر /v1/chat/completions و /v1/messages | لەبری ئەوە بە ڕێپێدانی بانگکردنی Shannon Coder هەژمار دەکرێت. |
داواکارییەک کە بە 401 وەڵام دراوەتەوە، یان بە 400 بۆ model ێکی نەناسراو | هەژمار ناکرێت. |
| داواکارییەک کە flood protection ڕەتی کردووەتەوە | بۆ پەنجەرەکە هەژمار دەکرێت. هیچ شتێک نرخ ناگیرێت. |
داواکاری پاڕالێل
هیچ سنوورێک نییە لەسەر ئەوەی هەژمارێک چەند داواکاری لە یەک کاتدا کراوە بێت، و هیچ هەڵەیەک نییە بۆ ناردنی داواکاری بە پاڕالێل. ئەو داواکارییانەی ناتوانن یەکسەر دەست پێبکەن لە ڕیزدا چاوەڕێ دەکەن و بە نۆرە وەڵام دەدرێنەوە.
- هەر داواکارییەک لە 120 بۆ هەر خولەکێک هەژمار دەکرێت کاتێک دەگات، جا داواکارییە پێشووەکان تەواو بووبن یان نا.
- هەر داواکارییەک ڕاگرتنی خۆی هەڵدەگرێت تا کۆتایی دێت. بیست داواکاری کراوە بە بودجەی output ی بنەڕەتی 20 × 4,096 = 81,920 تۆکنی باڵانس ڕادەگرن. ئەگەر ڕاگرتنەکان پێکەوە لە باڵانسەکەت گەورەتر بن، داواکاری دواتر وەڵامی
Quota exceededوەردەگرێت، هەرچەندە بانگکردنە تەواوبووەکان کەمتریان تێدەچوو.max_tokensێکی بچووکتر کەمتر ڕادەگرێت. - داواکارییەک بەبێ streaming هیچ ناگەیەنێت تا وەڵامەکەی تەواو دەبێت، بۆیە timeout ێک بە کلاینتەکەت بدە کە چاوەڕێکردنەکە دابپۆشێت. stream لەکاتی چاوەڕێکردندا پەیوەندییەکەی کراوە دەهێڵێتەوە. Streaming
سنوورەکانی یەک داواکاری
| سنوور | بەها | لەسەر چی جێبەجێ دەبێت | لە سنوور |
|---|---|---|---|
| body ی داواکاری | 32 MiB (33,554,432 بایت) | هەموو endpoint ێک | Status ی 413، جۆری invalid_request_error. |
بودجەی output: max_tokens، max_completion_tokens، max_output_tokens | 1 تا 65,536. بنەڕەتی 4,096؛ بۆ shannon-coder-1 لەسەر /v1/chat/completions و /v1/messages بنەڕەتی 65,536 ە. | هەموو مۆدێلێک، وەک بڕی ڕاگیراو لە باڵانسەکەت. وەک سنووری درێژی وەڵام: مۆدێلە open-weight ـە میوانداریکراوەکان، shannon-1.6-lite، shannon-1.6-pro و shannon-coder-1. | بەهایەک لە دەرەوەی ڕێژەکە دەبرێتە نزیکترین کۆتایی ڕێژەکە. هەڵە نییە. |
ڕیزبەندی وەستان: stop، stop_sequences | 4 string | مۆدێلە open-weight ـە میوانداریکراوەکان | یەکەم 4 string ی نەبەتاڵ بەکاردێن. |
| وێنە یان فایلێک کە وەک URL دراوە | 8 MiB، لەناو 20 چرکەدا دەخوێنرێتەوە، زۆرینە 5 redirect، ناونیشانی گشتیی http یان https | هەموو endpoint ێک کە وێنە یان فایل وەردەگرێت | داواکارییەکە بەبێ ئەو بەشە وەڵام دەدرێتەوە. هەڵە نییە. |
| وێنە یان فایلێک کە ناوەکی نێردرابێت (base64) | سنوورێکی تایبەتی نییە. لە body ی داواکاری 32 MiB دا هەژمار دەکرێت. | هەموو endpoint ێک کە وێنە یان فایل وەردەگرێت | Status ی 413 بۆ هەموو داواکارییەکە. |
text ی POST /v1/tokenize | 4,000,000 بایت | /v1/tokenize | Status ی 413، جۆری invalid_request_error، پەیامی text too long. |
messages ی POST /v1/tokenize و body ی POST /v1/messages/count_tokens | body ی داواکاری 32 MiB | هەردوو endpoint ی هەژمارکردن | Status ی 413. |
| Context window | بۆ هەر مۆدێلێک: context_window لە GET /v1/models | هەموو مۆدێلێک | ئەوەی بەسەر گفتوگۆیەکی درێژتردا دێت بەپێی مۆدێلەکەیە. مۆدێل و نرخ |
گەڕانەکانی وێب (web_search: true) | بۆ هەر پلان و ڕۆژێک: Free 3، Plus 30، Standard 50، Pro 60. یەک گەڕان بۆ داواکارییەک هەژمار دەکرێت کە گەڕانەکەی ئەنجامی دۆزیبێتەوە. | داواکارییەکان کە web_search: true دادەنێن | کاتێک هیچ نەمێنێت داواکارییەکە بەبێ گەڕان وەڵام دەدرێتەوە. هەڵە نییە. Lêgerîna webê |
هەڵەکان
وەڵامەکانی ئەم لاپەڕەیە. لەسەر /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 | بانگکردنەکانی Shannon Coder ی پەنجەرەی 4 کاتژمێریی ئێستا تەواو بوون. |
429 | rate_limit_error | Shannon routes are temporarily busy. Please retry. | مۆدێلەکە لەم ساتەدا ناتوانێت داواکارییەکە وەربگرێت. دوای وەستانێکی کورت دووبارە بینێرە. |
503 | api_error | Could not verify your quota right now. Please retry. | باڵانسەکەت نەخوێنرایەوە. هیچ شتێک نرخ ناگیرێت؛ داواکارییەکە دووبارە بنێرە. لەسەر /v1/responses لەگەڵ مۆدێلی Shannon status ەکە 500 ە. |
413 | invalid_request_error | body ی داواکارییەکە لە 32 MiB گەورەترە. لەسەر endpoint ـەکانی فۆرماتی OpenAI ئۆبجێکتی error code: "request_too_large" هەڵدەگرێت. | |
413 | invalid_request_error | text too long | text ی POST /v1/tokenize لە 4,000,000 بایت درێژترە. |