Amathuluzi e-CLI okukhoda

Ithuluzi lekhodi lidinga izilungiselelo ezintathu ukuze lisebenze ne-Shannon: i-base URL ye-API, i-API key yakho, ne-id ye-model ye-Shannon. Leli khasi linikeza izilungiselelo eziqondile ze-Claude Code ne-Codex CLI, lichaza ukuthi i-model yekhodi shannon-coder-1 ibalwa kanjani, futhi libala amaphutha la mathuluzi ahlangana nawo.

I-endpoint ethuluzi ngalinye elisebenzisa yona

Wonke ama-endpoint amathathu amukela i-API key efanayo, njenge-Authorization: Bearer noma njenge-x-api-key. Ama-header e-anthropic-version, anthropic-beta ne-openai-beta athunyelwa yilawa mathuluzi ayamukelwa.

Khetha i-model ye-Shannon

Isicelo ngasinye kufanele siqambe i-id ye-model eshicilelwa yi-Shannon. Ithuluzi lekhodi lithumela igama le-model yalo ezenzakalelayo ngaphandle kokuba ulitshele ngenye indlela, futhi igama elingashicilelwa yi-Shannon liphendulwa nge-400 nomlayezo unknown model: <name>. Alikho elinye igama elihlanganiswa ne-model ye-Shannon, ngakho setha i-model ethulwini ngaphambi kwesicelo sokuqala.

I-GET /v1/models ibala yonke ama-id ngewindi lomongo. Ayidingi key. Ama-model namanani

Amathuluzi ekhodi aqondisa i-model nge-system prompt ende. I-system prompt isetshenziswa yi-shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro nama-model e-open-weight ahlinzekiwe, ngakho khetha eyodwa yalawa ethuluzini lekhodi.

Claude Code

I-Claude Code ifunda uxhumo lwayo kuma-environment variable. Wasethe ku-shell eyiqalisayo, noma ku-block ye-env ye-~/.claude/settings.json ukuze uwagcine kuzo zonke amaseshini wonke.

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

• Setha onke ama-variable amathathu e-ANTHROPIC_DEFAULT_…_MODEL. Ama-subagent nemiyalo ethile icela i-model ngegama layo elakhelwe ngaphakathi, futhi igama ngalinye kufanele lixazululwe libe yi-id ye-Shannon.
• Isampula ikhomba izicelo zangemuva ku-shannon-1.6-lite, ebalwa ngama-token. Izihloko zamaseshini nezicelo ezifanayo bese zingasebenzisi izicelo ze-Coder.
• I-Claude Code icela i-POST /v1/messages/count_tokens osayizi womongo. I-endpoint ibala kuma-model e-open-weight ahlinzekiwe. Nge-id ye-Shannon iphendula nge-400; i-Claude Code ithatha ukubalwa kwama-token njengokungaphoqelekile futhi ilinganisa osayizi ngokwayo. Ukubala ama-token

Ukuhlola ikheli, i-key ne-id ye-model ngaphambi kokuqala ithuluzi, thumela isicelo esisodwa ngesandla:

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

I-Codex CLI ikhuluma ne-Responses API. Chaza i-Shannon njengomhlinzeki we-model ku-~/.codex/config.toml, khetha lapho i-id ye-model ye-Shannon, bese ufaka i-API key yakho ku-environment variable eqanjwe ngumhlinzeki.

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

• I-/v1/responses ayigcini ingxoxo ku-server: isicelo ngasinye siphatha ingxoxo ku-input. I-previous_response_id iyamukelwa ukuze kuhambisane.
• Amathuluzi omsebenzi (type: "function") anikezwa i-model ku-/v1/responses.
• Ku-/v1/responses, i-shannon-coder-1 ibalwa ngama-token asuka ku-balance yakho, hhayi ngezicelo ze-Coder.

Ukuhlola okufanayo kwe-endpoint ye-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."
  }'

I-model yekhodi nendlela ebalwa ngayo

I-shannon-coder-1 iyi-model ye-Shannon yama-agent ekhodi. I-GET /v1/models iyibika ngewindi lomongo lama-token angu-131,072, ukubiza amathuluzi, ukucabanga nokufakwayo kombhalo. Ibalwa ngenye yezindlela ezimbili, kuya nge-endpoint ethuluzi elisebenzisa yona.

Isicelo siyisicelo esisodwa, noma ngabe sikhulu kangakanani. Sibalwa uma isicelo samukelwa, ngaphambi kokuba i-model iphendule. Iseshini ye-agent sithumela isicelo esisodwa esinyathelweni ngasinye esisithathayo, ngakho umsebenzi omude usebenzisa izicelo eziningi. I-allowance incike epulanini lakho futhi iqala futhi njalo emahoreni angu-4, ngo-00:00, 04:00, 08:00, 12:00, 16:00 no-20:00 UTC.

Ikhasi lepulani libonisa izinombolo zamanje. Amapulani

Uma izicelo zewindi sezisetshenzisiwe, isicelo siphendulwa nge-429. Ku-/v1/messages iphutha elifanayo lifika ngesimo se-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"
  }
}

Umongo ogcwele ngokweqile

Uma ingxoxo inkulu kunewindi lomongo le-model, i-/v1/chat/completions na-/v1/messages ziphendula nge-400, uhlobo invalid_request_error, ikhodi context_length_exceeded nomlayezo oqala nge-prompt is too long. Amathuluzi ekhodi afunda leli phutha ukuze afinyeze iseshini bese ethumela isicelo futhi. Likhiqizwa yi-shannon-coder-1, shannon-1.6-lite ne-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
  }
}

Umlayezo uthi prompt is too long: <sent> tokens > <limit> maximum. Uma izinombolo zombili zingaziwa uthi prompt is too long. Please compact the conversation and try again.

Ku-stream isimo sesivele sithi 200, ngakho iphutha lifika njengomcimbi bese i-stream ivalwa ngendlela evamile:

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

Lokho isiyingi se-agent esingathembela kukho

Ukuxazulula izinkinga

I-key yakho ne-balance yakho kukhasi le-Ama-key nokusetshenziswa. Ama-key nokusetshenziswa