Gafee gaa n'ọdịnaya
Limits na balance

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.

Ọpụrụ ego Gbanwee plan

Ihe request na-edebe na ihe ọ na-efu

  • Debe — Mgbe request bịarutere ọ na-edebe output budget ya site na balance gị: max_tokens na /v1/chat/completions na /v1/messages, max_output_tokens na /v1/responses. /v1/chat/completions na-agụkwa max_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_tokens dị 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
  • usage nwere ọ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/messages nwere hosted open-weight model, input_tokens bụ akụkụ uncached nke input, cache_read_input_tokens bụ akụkụ cached ma cache_creation_input_tokens bụ mgbe niile 0.
  • Stream na /v1/chat/completions na-ebu usage na 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"
  }
}

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_tokens dị 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_tokens nke shannon-coder-1 na endpoints abụọ a bụ 65,536.
  • Mgbe calls agwụla azịza bụ status 429, ụdị rate_limit_error, ozi Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan.
  • Na /v1/responses, shannon-coder-1 enweghị 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_error na ozi Too many requests. Retry in <N>s. N bụ ọ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."
  }
}
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_tokens dị 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.