Uirlisí CLI códaithe

Teastaíonn trí shocrú ó uirlis chódaithe chun oibriú le Shannon: URL bonn an API, d'eochair API, agus id múnla Shannon. Tugann an leathanach seo na socruithe cruinne do Claude Code agus Codex CLI, míníonn sé conas a chomhairtear an múnla códaithe shannon-coder-1, agus liostaíonn sé na hearráidí a bhuaileann na huirlisí seo.

Cén críochphointe a úsáideann gach uirlis

Glacann na trí chríochphointe leis an eochair API chéanna, mar Authorization: Bearer nó mar x-api-key. Glactar leis na ceanntásca anthropic-version, anthropic-beta agus openai-beta a sheolann na huirlisí seo.

Roghnaigh múnla Shannon

Caithfidh gach iarratas id múnla a ainmniú a fhoilsíonn Shannon. Seolann uirlis chódaithe ainm a múnla réamhshocraithe féin mura n-insíonn tú di a mhalairt, agus freagraítear ainm nach bhfoilsíonn Shannon le 400 agus an teachtaireacht unknown model: <name>. Ní mhapáiltear aon ainm eile chuig múnla Shannon, mar sin socraigh an múnla san uirlis roimh an gcéad iarratas.

Liostaíonn GET /v1/models gach id lena fhuinneog comhthéacs. Ní theastaíonn eochair uaidh. Múnlaí agus praghsáil

Stiúrann uirlisí códaithe an múnla le prompt córais fada. Cuireann shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro agus na múnlaí open-weight óstáilte an prompt córais i bhfeidhm, mar sin roghnaigh ceann acu seo d'uirlis chódaithe.

Claude Code

Léann Claude Code a cheangal ó athróga timpeallachta. Socraigh iad sa bhlaosc a thosaíonn é, nó i mbloc env de ~/.claude/settings.json chun iad a choinneáil do gach seisiún.

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Where to send requests, and your Shannon API key
export ANTHROPIC_BASE_URL=https://api.shannon-ai.com
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

# Shannon model ids: the session model, and the model behind each built-in name
export ANTHROPIC_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_OPUS_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_SONNET_MODEL=shannon-coder-1
export ANTHROPIC_DEFAULT_HAIKU_MODEL=shannon-1.6-lite

# The context window of the session model
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=131072

claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.shannon-ai.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "shannon-coder-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "shannon-1.6-lite",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "131072"
  }
}

• Socraigh na trí athróg ANTHROPIC_DEFAULT_…_MODEL. Iarrann fo-ghníomhairí agus orduithe áirithe múnla lena ainm ionsuite, agus caithfidh gach ainm réiteach go id Shannon.
• Díríonn an sampla iarratais chúlra ar shannon-1.6-lite, a chomhairtear i token. Ansin ní úsáideann teidil seisiúin agus iarratais mar iad glaonna Coder.
• Iarrann Claude Code ar POST /v1/messages/count_tokens méid an chomhthéacs. Comhaireann an críochphointe do na múnlaí open-weight óstáilte. Le id Shannon freagraíonn sé 400; caitheann Claude Code le comhaireamh token mar rud roghnach agus déanann sé meastachán ar an méid é féin. Comhaireamh token

Chun an seoladh, an eochair agus id múnla a sheiceáil sula dtosaíonn tú an uirlis, seol iarratas amháin de láimh:

curl https://api.shannon-ai.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "Say OK."}]
  }'

Codex CLI

Labhraíonn Codex CLI leis an Responses API. Déan cur síos ar Shannon mar sholáthraí múnla in ~/.codex/config.toml, roghnaigh id múnla Shannon ansin, agus cuir d'eochair API san athróg timpeallachta a ainmníonn an soláthraí.

model = "shannon-coder-1"
model_provider = "shannon"
model_context_window = 131072

[model_providers.shannon]
name = "Shannon"
base_url = "https://api.shannon-ai.com/v1"
env_key = "SHANNON_API_KEY"
wire_api = "responses"

# Install Codex CLI
npm install -g @openai/codex

# Your Shannon API key, under the name given as env_key
export SHANNON_API_KEY=YOUR_API_KEY

# Start it; --model selects another Shannon id for one run
codex
codex --model shannon-1.6-pro

• Ní choinníonn /v1/responses aon chomhrá ar an bhfreastalaí: iompraíonn gach iarratas an comhrá in input. Glactar le previous_response_id ar mhaithe le comhoiriúnacht.
• Cuirtear uirlisí feidhme (type: "function") os comhair an mhúnla ar /v1/responses.
• Ar /v1/responses, comhairtear shannon-coder-1 i token ó d'iarmhéid, ní i nglaonna Coder.

An tseiceáil chéanna don chríochphointe Responses:

curl https://api.shannon-ai.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "input": "Say OK."
  }'

An múnla códaithe agus conas a chomhairtear é

Is é shannon-coder-1 an múnla Shannon do ghníomhairí códaithe. Tuairiscíonn GET /v1/models é le fuinneog comhthéacs de 131,072 token, glaonna uirlisí, réasúnaíocht agus ionchur téacs. Comhairtear é ar cheann de dhá bhealach, ag brath ar an gcríochphointe a úsáideann uirlis.

Is é glao iarratas amháin, cibé méid atá air. Comhairtear é nuair a ghlactar leis an iarratas, sula bhfreagraíonn an múnla. Seolann seisiún gníomhaire iarratas amháin do gach céim a thógann sé, mar sin úsáideann tasc fada a lán glaonna. Braitheann an liúntas ar do phlean agus tosaíonn sé arís gach 4 uair an chloig, ag 00:00, 04:00, 08:00, 12:00, 16:00 agus 20:00 UTC.

Taispeánann leathanach an phlean na huimhreacha reatha. Pleananna

Nuair a úsáidtear glaonna fuinneoige go léir, freagraítear an t-iarratas le 429. Ar /v1/messages tagann an earráid chéanna i gcruth Anthropic.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan"
  }
}

Comhthéacs ag cur thar maoil

Nuair a bhíonn comhrá níos mó ná fuinneog comhthéacs an mhúnla, freagraíonn /v1/chat/completions agus /v1/messages le 400, an cineál invalid_request_error, an cód context_length_exceeded agus teachtaireacht a thosaíonn le prompt is too long. Léann uirlisí códaithe an earráid seo chun an seisiún a dhlúthú agus an t-iarratas a sheoladh arís. Táirgeann shannon-coder-1, shannon-1.6-lite agus shannon-1.6-pro í.

{
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "code": "context_length_exceeded",
    "message": "prompt is too long: 140211 tokens > 131072 maximum",
    "param": null
  }
}

Is í an teachtaireacht prompt is too long: <sent> tokens > <limit> maximum. Nuair nach bhfuil an dá uimhir ar eolas is í prompt is too long. Please compact the conversation and try again. í.

Ar shruth tá an stádas 200 cheana, mar sin tagann an earráid mar imeacht agus ansin dúntar an sruth ar an ngnáthbhealach:

data: {"error":{"message":"prompt is too long: 140211 tokens > 131072 maximum","type":"invalid_request_error","code":"context_length_exceeded","param":null}}

data: {"id":"chatcmpl-…","object":"chat.completion.chunk","created":…,"model":"shannon-coder-1","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{…}}

data: [DONE]

event: error
data: {"type":"error","error":{"type":"invalid_request_error","message":"prompt is too long: 140211 tokens > 131072 maximum"}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{…}}

event: message_stop
data: {"type":"message_stop"}

An rud ar féidir le lúb gníomhaire brath air

Fabhtcheartú

Tá d'eochair agus d'iarmhéid ar an leathanach Eochracha agus úsáid. Eochracha agus úsáid