Limits na balance
A na-ejere request ọ bụla otu aka. Enweghị rate tiers. Enweghị API quota dị iche. I kwụọlarị ụgwọ tokens gị — jiri ha ngwa ngwa ka ị chọrọ.
Peeji a na-akọwa ihe balance gị mejupụtara, ihe otu request na-edebe na ihe ọ na-efu, ole requests ị nwere ike izipu, na ole na ole limits request ofụ nwere ike ịzute.
- uru nke tokens 1M nke balance
- $5.00
- daily allowance na-eme ọhụrụ
- 00:00 UTC
- flood protection, kwa akaụntụ
- 120 requests / nkeji
Otu a na-esi ejere requests ozi
- Enweghị rate tiers — Otu iwu na-ejedebe ngwa requests nwere ike ịbịa, ọ bụkwa otu maka akaụntụ ọ bụla na plan ọ bụla: requests 120 n'otu nkeji. Enweghị oke maka tokens n'otu nkeji.
- Enweghị API quota dị iche — API na-eji otu balance dị ka chat. Plan na-atọ nha allowance nke taa. Ọ naghị atọ ọnụego request.
- Ngwa ngwa ka ị chọrọ — A na-anabata requests e zipụrụ n'otu oge ma ha na-eche n'ahịrị. A naghị ajụ ha n'ihi na ha dị n'otu oge.
Balance gị
A na-agụ balance gị na tokens. Tokens 1,000,000 nke balance bara uru $5.00, ọnụahịa ọ bụla dị na peeji Models & pricing bụ rate megide uru ahụ.
N'oge ọ bụla balance bụ ngụkọta nke akụkụ abụọ.
- Plan allowance nke taa — Ọnụọgụ tokens plan gị tọrọ. Ọ na-adị ọhụrụ kwa ụbọchị na 00:00 UTC. Ihe fọdụrụ na njedebe nke ụbọchị anaghị aga n'ihu.
- Credit a zụrụ — Tokens i zụtara dị ka pack. Credit anaghị agwụ oge ma na-arụ ọrụ na plan ọ bụla, gụnyere Free.
| Plan | Tokens kwa ụbọchị | Uru |
|---|---|---|
| Free | 30,000 | $0.15 |
| Plus | 80,000 | $0.40 |
| Standard | 265,000 | $1.325 |
| Pro | 665,000 | $3.325 |
- Usoro mmefu — Request ọ bụla na-ebu ụzọ eji plan allowance nke taa. A na-eji purchased credit naanị maka ihe karịrị allowance ahụ n'ụbọchị ahụ.
- Chat na API na-ekekọrịta ya — Enwere otu balance maka akaụntụ. API key na-eji balance nke akaụntụ nwe ya, na otu ọnụahịa dị ka chat.
- Packs — A na-ere credit n'ime packs nke tokens 1,000,000 ($5.00), 2,000,000 ($10.00) na 5,000,000 ($25.00), ma ọ bụ dị ka ọnụọgụ i họrọ site na tokens 1,000,000 ruo 100,000,000 na $5.00 kwa 1,000,000.
Ihe request na-edebe na ihe ọ na-efu
- Debe — Mgbe request bịarutere ọ na-edebe output budget ya site na balance gị:
max_tokensna/v1/chat/completionsna/v1/messages,max_output_tokensna/v1/responses./v1/chat/completionsna-agụkwamax_completion_tokens. Default bụ 4,096 oke bụ 1 ruo 65,536. - Nabata — A na-anabata request naanị ma reservation ahụ bà n'ime ihe fọdụrụ na balance gị. Balance dị n'elu efu mana pere mpe karịa output budget na-enweta azịza
Quota exceeded. Zipụmax_tokensdị ntakịrị iji jiri ihe fọdụrụ. - Mezue — Mgbe azịza zuru ezu, reservation na-anọchi ụgwọ n'ezie. Ụgwọ ahụ nwere ike ịdị ala ma ọ bụ dị elu karịa reservation.
- Laghachi — Request na-ejedebe na njehie status na-enyeghachi reservation ya n'ụzọ zuru ezu.
Ụgwọ n'ezie na-adabere na model family.
| Models | Ihe a na-akwụ ụgwọ |
|---|---|
| Shannon models | usage.total_tokens na ọnụahịa model kwa 1M. Input na output nwere otu rate. |
| Hosted open-weight models | Uncached input na input rate, cached input na cached rate, output na output rate. |
A na-ewepụ ego USD site na balance gị na tokens na $5.00 kwa 1,000,000, gbagoro elu ruo token zuru ezu.
Ịgụ tokens site na POST /v1/tokenize ma ọ bụ POST /v1/messages/count_tokens bụ n'efu ma anaghị edebe ihe ọ bụla. Ịgụ tokens
Ebe ịhụ balance na ojiji
Peeji Keys & usage na-egosi ihe ị nwere ike ime ugbu a, plan allowance nke taa, purchased credit gị na API spend nke ụbọchị 30 gara aga. N'okpuru nke ahụ ọ na-depụta request ọ bụla key gị mere: oge, endpoint, model, cached input, tokens akwụrụ ụgwọ na ọnụahịa. Keys & usage
Azịza ọ bụla nwekwara object usage nwere ọnụọgụ tokens nke call ahụ.
| Endpoint | Fields nke usage | Hosted open-weight models na-agbakwunye |
|---|---|---|
/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 |
usagenwere ọnụọgụ tokens nke model. Ego a wepụrụ na balance gị adịghị n'azịza: ọ bụ kọlụm Billed tokens nke ndepụta request dị na Keys & usage.- Na
/v1/messagesnwere hosted open-weight model,input_tokensbụ akụkụ uncached nke input,cache_read_input_tokensbụ akụkụ cached macache_creation_input_tokensbụ mgbe niile0. - Stream na
/v1/chat/completionsna-ebuusagena chunk ikpeazụ ya tupu[DONE]. Nzipu ozugbo
Mgbe balance gwụrụ
Request nke reservation ya abaghị n'ime balance gị na-enweta azịza status 429, ụdị rate_limit_error na ozi dị n'okpuru. A naghị akwụ ụgwọ ọ bụla. A na-ezipu otu azịza ahụ mgbe balance dị n'elu efu mana pere mpe karịa output budget nke request.
{
"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"
}
} Na /v1/responses object error nwekwara ike ibu code na param, ha abụọ null.
Ihe ị nwere ike ime:
- Chere plan allowance na-esote na 00:00 UTC.
- Top up credit. A na-eji credit mgbe plan allowance gasịrị ma ọ naghị agwụ oge. Ọpụrụ ego
- Gbanwee gaa plan nwere daily allowance ka ukwuu. Gbanwee plan
- Zipụ
max_tokensdị ntakịrị, ma ọ bụrụ na balance fọdụrụ: mgbe ahụ reservation dị ntakịrị.
Shannon Coder call allowance
A na-agụ shannon-coder-1 na /v1/chat/completions na /v1/messages na calls, ọ bụghị na tokens. Plan ọ bụla nwere ọnụọgụ calls kwa 4-hour window. Otu request bụ otu call.
| Plan | Calls kwa 4-hour window |
|---|---|
| Free | 3 |
| Plus | 20 |
| Standard | 40 |
| Pro | 60 |
- Windows na-amalite na 00:00, 04:00, 08:00, 12:00, 16:00, 20:00 UTC. Calls fọdụrụ na njedebe nke window anaghị aga n'ihu.
- A na-agụ call mgbe a nabatara request, tupu model aza. Request dara mgbe nke ahụ gasịrị ka na-agụ dị ka call.
- Calls ndị a anaghị edebe tokens ma anaghị ewepụ ihe ọ bụla na balance gị. Ndepụta request dị na Keys & usage na-egosi ọnụọgụ tokens ha na uru ya n'ọnụahịa edepụtara.
- Default
max_tokensnkeshannon-coder-1na endpoints abụọ a bụ 65,536. - Mgbe calls agwụla azịza bụ status
429, ụdịrate_limit_error, oziShannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan. - Na
/v1/responses,shannon-coder-1enweghị call allowance: a na-akwụ ụgwọ ya na tokens site na balance gị na $8.00 kwa 1M, dị ka model ọ bụla ọzọ.
Flood protection
Akaụntụ nwere ike izipu requests 120 n'otu nkeji. Nke ahụ bụ naanị oke maka ọnụego request, ọ bụkwa otu ihe na plan ọ bụla. Ọ dị iji kwụsị floods, ọ bụghị iji belata ojiji nkịtị.
- Nkeji ahụ bụ window kwụsiri ike nke sekọnd 60 na-emepe na request mbụ gị. Mgbe ọ gwụrụ, ọnụọgụ na-amalite ọzọ site na efu.
- A na-agụ ya maka akaụntụ, ọ bụghị maka key ma ọ bụ IP address. Ịgbanwe key anaghị emeghe window ọhụrụ.
- Request nke 121 n'ime window na-enweta azịza status
429, ụdịrate_limit_errorna oziToo many requests. Retry in <N>s.Nbụ ọnụọgụ sekọnd ruo mgbe window gwụrụ, site na 1 ruo 60. - A na-elele flood protection tupu balance. Request ọ jụrụ anaghị edebe ihe ọ bụla ma ọ naghị efu ihe.
{
"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."
}
} | Request | Flood protection |
|---|---|
POST /v1/chat/completions, POST /v1/messages, POST /v1/responses | A na-agụ, otu maka request ọ bụla. |
GET /v1/models, POST /v1/tokenize, POST /v1/messages/count_tokens | A naghị agụ. |
shannon-coder-1 na /v1/chat/completions na /v1/messages | A na-agụ ya site na Shannon Coder call allowance kama. |
Request e zara na 401, ma ọ bụ na 400 maka model amabeghị | A naghị agụ. |
| Request flood protection jụrụ | A na-agụ n'ime window. A naghị akwụ ụgwọ ọ bụla. |
Requests n'otu oge
Enweghị oke maka ole requests akaụntụ nwere ike ịmeghe n'otu oge, enweghịkwa njehie maka izipu requests n'otu oge. Requests enweghị ike ịmalite ozugbo na-eche n'ahịrị ma a na-aza ha n'usoro.
- Request ọ bụla na-agụ n'ime 120 n'otu nkeji mgbe ọ bịarutere, ma requests gara aga mechiela ma ọ bụ mechiebeghị.
- Request ọ bụla na-ejide reservation nke ya ruo mgbe ọ gwụrụ. Requests iri abụọ meghere nwere default output budget na-ejide 20 × 4,096 = 81,920 tokens nke balance. Ọ bụrụ na reservations ọnụ buru ibu karịa balance gị, request na-esote na-enweta azịza
Quota exceeded, ọbụlagodi na calls gwụchara ga-efu obere.max_tokensdị ntakịrị na-ejide obere. - Request na-enweghị streaming anaghị ezipu ihe ọ bụla ruo mgbe azịza zuru ezu, ya mere nye client gị timeout kpuchiri ichere. Stream na-edebe njikọ ya mepere mgbe ọ na-eche. Nzipu ozugbo
Limits nke otu request
| Oke | Uru | Na-emetụta | Na oke |
|---|---|---|---|
| Request body | 32 MiB (33,554,432 bytes) | Endpoint ọ bụla | Status 413, ụdị invalid_request_error. |
Output budget: max_tokens, max_completion_tokens, max_output_tokens | 1 ruo 65,536. Default 4,096; maka shannon-coder-1 na /v1/chat/completions na /v1/messages default bụ 65,536. | Model ọ bụla, dị ka ego edebere site na balance gị. Dị ka oke maka ogologo azịza: hosted open-weight models, shannon-1.6-lite, shannon-1.6-pro na shannon-coder-1. | A na-ebugharị uru dị n'èzí oke gaa na njedebe kacha nso nke oke ahụ. Enweghị njehie. |
Stop sequences: stop, stop_sequences | Strings 4 | Hosted open-weight models | A na-eji strings 4 izizi na-abụghị efu. |
| Image ma ọ bụ file enyere dị ka URL | 8 MiB, a na-agụ n'ime sekọnd 20, redirects 5 kacha, adreesị http ma ọ bụ https ọha | Endpoint ọ bụla na-anara images ma ọ bụ files | A na-aza request na-enweghị akụkụ ahụ. Enweghị njehie. |
| Image ma ọ bụ file e zipụrụ inline (base64) | Enweghị oke nke ya. Ọ na-agụ n'ime 32 MiB request body. | Endpoint ọ bụla na-anara images ma ọ bụ files | Status 413 maka request dum. |
text nke POST /v1/tokenize | Bytes 4,000,000 | /v1/tokenize | Status 413, ụdị invalid_request_error, ozi text too long. |
messages nke POST /v1/tokenize na body nke POST /v1/messages/count_tokens | 32 MiB request body | Counting endpoints abụọ ahụ | Status 413. |
| Context window | Maka model ọ bụla: context_window na GET /v1/models | Model ọ bụla | Ihe na-eme mkparịta ụka ka ogologo na-adabere na model. Models & ọnụahịa |
Web searches (web_search: true) | Kwa plan na ụbọchị: Free 3, Plus 30, Standard 50, Pro 60. A na-agụ otu search maka request nke search ya chọtara results. | Requests na-ewepụta web_search: true | Mgbe ọ nweghị nke fọdụrụ a na-aza request na-enweghị search. Enweghị njehie. Chọọ weebụ |
Njehie
Azịza nke peeji a. Na /v1/messages otu object error ahụ ka e kechiri dị ka {"type": "error", "error": {…}}.
| Status | Ụdị | Ozi | Mgbe, na ihe a ga-eme |
|---|---|---|---|
429 | rate_limit_error | Quota exceeded. Upgrade your plan at shannon-ai.com/plan | Reservation nke request abaghị n'ime balance gị. Chere 00:00 UTC, top up credit, gbanwee plan, ma ọ bụ zipụ max_tokens dị ntakịrị. |
429 | rate_limit_error | Too many requests. Retry in <N>s. | Karịa requests 120 n'nkeji dị ugbu a. Chere sekọnd N ma zighachi. |
429 | rate_limit_error | Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan | Ejiri Shannon Coder calls niile nke 4-hour window dị ugbu a. |
429 | rate_limit_error | Shannon routes are temporarily busy. Please retry. | Model enweghị ike ịnara request n'oge a. Zighachi ya mgbe obere ikwụsị gasịrị. |
503 | api_error | Could not verify your quota right now. Please retry. | Enweghị ike ịgụ balance gị. A naghị akwụ ụgwọ ọ bụla; zighachi request ahụ. Na /v1/responses nwere Shannon model status bụ 500. |
413 | invalid_request_error | Request body buru ibu karịa 32 MiB. Na OpenAI-format endpoints object error nwere code: "request_too_large". | |
413 | invalid_request_error | text too long | text nke POST /v1/tokenize ka ogologo karịa bytes 4,000,000. |