Għodod CLI għall-kodiċi

Għodda tal-kodiċi teħtieġ tliet settings biex taħdem ma' Shannon: il-base URL tal-API, iċ-ċavetta tal-API tiegħek u id ta' mudell ta' Shannon. Din il-paġna tagħti s-settings eżatti għal Claude Code u Codex CLI, tispjega kif jingħadd il-mudell tal-kodiċi shannon-coder-1, u telenka l-iżbalji li jiltaqgħu magħhom dawn l-għodod.

Liema endpoint juża kull tool

It-tliet endpoints kollha jieħdu l-istess ċavetta tal-API, bħala Authorization: Bearer jew bħala x-api-key. L-headers anthropic-version, anthropic-beta u openai-beta li jibagħtu dawn it-tools jiġu aċċettati.

Agħżel mudell Shannon

Kull talba trid isem ta' id ta' mudell li Shannon tippubblika. Għodda tal-kodiċi tibgħat l-isem tal-mudell default tagħha stess sakemm ma tgħidilhiex mod ieħor, u isem li Shannon ma tippubblikax jitwieġeb b'400 u l-messaġġ unknown model: <name>. L-ebda isem ieħor ma jiġi mappjat għal mudell ta' Shannon, għalhekk issettja l-mudell fl-għodda qabel l-ewwel talba.

GET /v1/models telenka kull id bit-tieqa tal-kuntest tiegħu. Ma teħtieġ l-ebda ċavetta. Mudelli u prezzijiet

L-għodod tal-kodiċi jiggwidaw il-mudell b'system prompt twil. Is-system prompt jiġi applikat minn shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro u l-mudelli open-weight ospitati, għalhekk agħżel wieħed minn dawn għal għodda tal-kodiċi.

Claude Code

Claude Code jaqra l-konnessjoni tiegħu minn environment variables. Issettjahom fil-shell li jibdih, jew fil-blokk env ta' ~/.claude/settings.json biex iżżommhom għal kull sessjoni.

# 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"
  }
}

• Issettja t-tliet varjabbli ANTHROPIC_DEFAULT_…_MODEL. Is-subagents u xi kmandi jitolbu mudell bl-isem inkorporat tiegħu, u kull isem irid jissolva għal id ta' Shannon.
• L-eżempju jimmira t-talbiet fl-isfond lejn shannon-1.6-lite, li jingħadd f'tokens. It-titli tas-sessjoni u talbiet simili mbagħad ma jużawx sejħiet ta' Coder.
• Claude Code jitlob lil POST /v1/messages/count_tokens id-daqs tal-kuntest. L-endpoint jgħodd għall-mudelli open-weight ospitati. B'id ta' Shannon iwieġeb 400; Claude Code iqis l-għadd ta' tokens bħala mhux obbligatorju u jistma d-daqs huwa stess. Għadd ta' tokens

Biex tivverifika l-indirizz, iċ-ċavetta u l-id ta' mudell qabel tibda t-tool, ibgħat talba waħda bl-idejn:

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

Codex CLI jitkellem mal-Responses API. Iddeskrivi Shannon bħala provider tal-mudelli f'~/.codex/config.toml, agħżel hemm id ta' mudell Shannon, u poġġi ċ-ċavetta tal-API tiegħek fl-environment variable li l-provider isemmi.

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

• /v1/responses ma jżomm ebda konversazzjoni fuq is-server: kull talba ġġorr il-konversazzjoni f'input. previous_response_id jiġi aċċettat għall-kompatibilità.
• Tools tal-funzjonijiet (type: "function") jiġu offruti lill-mudell fuq /v1/responses.
• Fuq /v1/responses, shannon-coder-1 jingħadd f'tokens mill-bilanċ tiegħek, mhux f'sejħiet ta' Coder.

L-istess verifika għall-endpoint 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."
  }'

Il-mudell tal-kodiċi u kif jingħadd

shannon-coder-1 huwa l-mudell Shannon għall-aġenti tal-kodiċi. GET /v1/models jirrapportah b'tieqa tal-kuntest ta' 131,072 token, sejħiet ta' tools, raġunament u input tat-test. Jingħadd b'wieħed minn żewġ modi, skont l-endpoint li juża tool.

Sejħa hija talba waħda, ikun xi jkun id-daqs tagħha. Tingħadd meta t-talba tiġi aċċettata, qabel ma l-mudell iwieġeb. Sessjoni ta' aġent tibgħat talba waħda għal kull pass li tieħu, għalhekk kompitu twil juża ħafna sejħiet. Il-kwota tiddependi mill-pjan tiegħek u tibda mill-ġdid kull 4 sigħat, fis-00:00, 04:00, 08:00, 12:00, 16:00 u 20:00 UTC.

Il-paġna tal-pjanijiet turi n-numri attwali. Pjanijiet

Meta s-sejħiet ta' tieqa jintefqu, it-talba tiġi mwieġba b'429. Fuq /v1/messages l-istess żball jiġi fil-forma 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"
  }
}

Overflow tal-kuntest

Meta konversazzjoni tkun akbar mit-tieqa tal-kuntest tal-mudell, /v1/chat/completions u /v1/messages iwieġbu b'400, it-tip invalid_request_error, il-kodiċi context_length_exceeded u messaġġ li jibda b'prompt is too long. L-għodod tal-kodiċi jaqraw dan l-iżball biex jikkumpattaw is-sessjoni u jibagħtu t-talba mill-ġdid. Jiġi prodott minn shannon-coder-1, shannon-1.6-lite u 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
  }
}

Il-messaġġ huwa prompt is too long: <sent> tokens > <limit> maximum. Meta ż-żewġ numri ma jkunux magħrufa huwa prompt is too long. Please compact the conversation and try again.

Fuq stream l-istatus huwa diġà 200, għalhekk l-iżball jasal bħala avveniment u mbagħad l-istream jagħlaq b'mod normali:

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"}

Fuq xiex jista' jiddependi linja ta' aġent

Soluzzjoni ta' problemi

Iċ-ċavetta u l-bilanċ tiegħek jinsabu fil-paġna Keys & usage. Ċwievet u użu