Абзорҳои CLI барои барномасозӣ

Абзори барномасозӣ барои кор бо Shannon се танзим мехоҳад: base URL-и API, калиди API-и шумо ва id-и модели Shannon. Ин саҳифа танзимоти дақиқро барои Claude Code ва Codex CLI медиҳад, шарҳ медиҳад, ки модели барномасозии shannon-coder-1 чӣ тавр ҳисоб карда мешавад ва хатогиҳоеро номбар мекунад, ки ин абзорҳо дучор мешаванд.

Ҳар абзор кадом endpoint-ро истифода мебарад

Ҳар се endpoint ҳамон як калиди API-ро қабул мекунанд, ҳамчун Authorization: Bearer ё ҳамчун x-api-key. Сарлавҳаҳои anthropic-version, anthropic-beta ва openai-beta, ки ин абзорҳо мефиристанд, қабул мешаванд.

Модели Shannon-ро интихоб кунед

Ҳар дархост бояд id-и моделеро номбар кунад, ки Shannon нашр мекунад. Абзори барномасозӣ номи модели пешфарзи худро мефиристад, агар шумо ба он чизи дигар нагӯед, ва ба номе, ки Shannon нашр намекунад, бо 400 ва паёми unknown model: <name> ҷавоб дода мешавад. Ягон номи дигар ба модели Shannon иваз карда намешавад, бинобар ин моделро пеш аз аввалин дархост дар абзор муқаррар кунед.

GET /v1/models ҳар id-ро бо равзанаи контексташ номбар мекунад. Он калид намехоҳад. Моделҳо ва нархҳо

Абзорҳои барномасозӣ моделро бо system prompt-и дароз роҳнамоӣ мекунанд. System prompt-ро shannon-coder-1, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro ва моделҳои open-weight-и хостшуда татбиқ мекунанд, бинобар ин барои абзори барномасозӣ яке аз инҳоро интихоб кунед.

Claude Code

Claude Code пайвастшавии худро аз тағйирёбандаҳои муҳит мехонад. Онҳоро дар shell-е, ки онро оғоз мекунад, ё дар блоки env-и ~/.claude/settings.json танзим кунед, то барои ҳар ҷаласа нигоҳ дошта шаванд.

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

• Ҳар се тағйирёбандаи ANTHROPIC_DEFAULT_…_MODEL-ро танзим кунед. Subagent-ҳо ва баъзе фармонҳо моделро бо номи дарунсохташудаи он мепурсанд ва ҳар ном бояд ба id-и Shannon ҳал шавад.
• Намуна дархостҳои пасзаминаро ба shannon-1.6-lite равона мекунад, ки бо токен ҳисоб карда мешавад. Он гоҳ номи ҷаласаҳо ва дархостҳои монанд даъватҳои Coder-ро истифода намебаранд.
• Claude Code аз POST /v1/messages/count_tokens андозаи контекстро мепурсад. Endpoint барои моделҳои open-weight-и хостшуда ҳисоб мекунад. Бо id-и Shannon он 400 ҷавоб медиҳад; Claude Code ҳисоби токенро ихтиёрӣ мешуморад ва андозаро худаш арзёбӣ мекунад. Ҳисоби токенҳо

Барои санҷидани суроға, калид ва id-и модел пеш аз оғози абзор як дархостро дастӣ фиристед:

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 бо Responses API сӯҳбат мекунад. Shannon-ро ҳамчун провайдери модел дар ~/.codex/config.toml тавсиф кунед, id-и модели Shannon-ро дар он ҷо интихоб кунед ва калиди API-и худро ба тағйирёбандаи муҳите гузоред, ки провайдер номбар мекунад.

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 ягон гуфтугӯро дар сервер нигоҳ намедорад: ҳар дархост гуфтугӯро дар input мебарад. previous_response_id барои мувофиқат қабул мешавад.
• Абзорҳои функсия (type: "function") дар /v1/responses ба модел пешниҳод мешаванд.
• Дар /v1/responses shannon-coder-1 бо токенҳо аз балансатон ҳисоб карда мешавад, на бо даъватҳои Coder.

Ҳамин санҷиш барои 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."
  }'

Модели барномасозӣ ва чӣ тавр ҳисоб карда мешавад

shannon-coder-1 модели Shannon барои агентҳои барномасозист. GET /v1/models онро бо равзанаи контексти 131,072 токен, даъватҳои абзор, reasoning ва вуруди матнӣ ҳисобот медиҳад. Он бо яке аз ду роҳ ҳисоб карда мешавад, вобаста ба endpoint-е, ки абзор истифода мебарад.

Даъват як дархост аст, андозааш ҳар чӣ бошад. Он ҳангоми қабули дархост, пеш аз ҷавоби модел ҳисоб карда мешавад. Ҷаласаи агент барои ҳар қадаме, ки мегузорад, як дархост мефиристад, бинобар ин вазифаи дароз даъватҳои зиёдро истифода мебарад. Меъёр аз нақшаи шумо вобаста аст ва ҳар 4 соат аз нав оғоз мешавад, соати 00:00, 04:00, 08:00, 12:00, 16:00 ва 20:00 UTC.

Саҳифаи нақшаҳо рақамҳои ҷориро нишон медиҳад. Нақшаҳо

Вақте ки даъватҳои равзана тамом мешаванд, ба дархост бо 429 ҷавоб дода мешавад. Дар /v1/messages ҳамин хатогӣ дар шакли 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"
  }
}

Аз ҳад зиёд шудани контекст

Вақте ки гуфтугӯ аз равзанаи контексти модел калонтар аст, /v1/chat/completions ва /v1/messages бо 400, навъи invalid_request_error, рамзи context_length_exceeded ва паёме, ки бо prompt is too long оғоз мешавад, ҷавоб медиҳанд. Абзорҳои барномасозӣ ин хатогиро мехонанд, то ҷаласаро фишурда кунанд ва дархостро бори дигар фиристанд. Онро shannon-coder-1, shannon-1.6-lite ва 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
  }
}

Паём prompt is too long: <sent> tokens > <limit> maximum аст. Вақте ки ду адад маълум нест, он prompt is too long. Please compact the conversation and try again. аст.

Дар ҷараён ҳолат аллакай 200 аст, бинобар ин хатогӣ ҳамчун рӯйдод меояд ва баъд ҷараён ба тарзи муқаррарӣ баста мешавад:

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

Ба чӣ ҳалқаи агент такя карда метавонад

Ҳалли мушкилот

Калид ва балансатон дар саҳифаи Калидҳо ва истифода мебошанд. Калидҳо ва истифода