ئامرازەکانی کۆدنووسینی CLI

ئامرازێکی کۆدکردن سێ ڕێکخستنی پێویستە بۆ ئەوەی لەگەڵ Shannon کار بکات: base URL ی API، کلیلی API ـەکەت، و id ی مۆدێلێکی Shannon. ئەم لاپەڕەیە ڕێکخستنە وردەکانی Claude Code و Codex CLI دەدات، ڕوون دەکاتەوە مۆدێلی کۆدکردنی shannon-coder-1 چۆن هەژمار دەکرێت، و ئەو هەڵانە لیست دەکات کە ئەم ئامرازانە تووشیان دەبن.

هەر ئامرازێک کام endpoint بەکاردەهێنێت

هەر سێ endpoint ـەکە هەمان کلیلی API وەردەگرن، وەک Authorization: Bearer یان وەک x-api-key. headers ی anthropic-version، anthropic-beta و openai-beta کە ئەم ئامرازانە دەینێرن وەردەگیرێن.

مۆدێلێکی Shannon هەڵبژێرە

هەموو داواکارییەک دەبێت id ی مۆدێلێک بنووسێت کە Shannon بڵاوی کردووەتەوە. ئامرازی کۆدکردن ناوی مۆدێلی بنەڕەتیی خۆی دەنێرێت مەگەر پێی بڵێیت جیاواز بێت، و ناوێک کە Shannon بڵاوی نەکردبێتەوە بە 400 و پەیامی unknown model: <name> وەڵام دەدرێتەوە. هیچ ناوێکی دیکە بە مۆدێلێکی Shannon ناگەیەنرێت، بۆیە مۆدێلەکە لە ئامرازەکەدا دابنێ پێش یەکەم داواکاری.

GET /v1/models هەموو id ـەکان لەگەڵ context window ـەکەیان لیست دەکات. پێویستی بە کلیل نییە. مۆدێل و نرخ

ئامرازەکانی کۆدکردن مۆدێلەکە بە 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 بۆ ئەوەی بۆ هەموو session ێک بمێننەوە.

# 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 ـەکان و هەندێک فەرمان مۆدێلێک بە ناوی built-in ی خۆی داوا دەکەن، و هەر ناوێک دەبێت بگاتە id ێکی Shannon.
• نموونەکە داواکارییە باکگراوندەکان دەخاتە سەر shannon-1.6-lite، کە بە تۆکن هەژمار دەکرێت. ناونیشانی session و داواکاری هاوشێوە دواتر بانگکردنی Coder بەکارناهێنن.
• Claude Code لە POST /v1/messages/count_tokens قەبارەی context دەپرسێت. ئەم 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 وەک provider ی مۆدێل لە ~/.codex/config.toml پێناسە بکە، id ی مۆدێلێکی Shannon لەوێ هەڵبژێرە، و کلیلی API ـەکەت لەو گۆڕاوی ژینگەیەدا دابنێ کە provider ـەکە ناوی دەبات.

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 بۆ گونجاوی وەردەگیرێت.
• ئامرازەکانی function (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 ـە بۆ agent ـەکانی کۆدکردن. GET /v1/models ڕاپۆرتی دەکات بە context window ی 131,072 تۆکن، بانگکردنی ئامراز، بیرکردنەوە و input ی دەق. بە یەکێک لە دوو شێواز هەژمار دەکرێت، بەپێی ئەو endpoint ـەی ئامرازێک بەکاری دەهێنێت.

بانگکردن یەک داواکارییە، با قەبارەکەی هەرچی بێت. کاتێک داواکارییەکە وەردەگیرێت هەژمار دەکرێت، پێش ئەوەی مۆدێلەکە وەڵام بداتەوە. session ی agent بۆ هەر هەنگاوێک یەک داواکاری دەنێرێت، بۆیە ئەرکێکی درێژ بانگکردنی زۆر بەکاردێنێت. ڕێپێدانەکە بەپێی پلانەکەتە و لە هەر 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"
  }
}

لێڕژانی context

کاتێک گفتوگۆیەک لە context window ی مۆدێلەکە گەورەتر بێت، /v1/chat/completions و /v1/messages بە 400، جۆری invalid_request_error، کۆدی context_length_exceeded و پەیامێک وەڵام دەدەنەوە کە بە prompt is too long دەست پێدەکات. ئامرازەکانی کۆدکردن ئەم هەڵەیە دەخوێننەوە بۆ ئەوەی session ەکە بپەستێنن و داواکارییەکە دووبارە بنێرن. لەلایەن 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. ە.

لەسەر stream دا statusـەکە پێشتر 200 ە، بۆیە هەڵەکە وەک ڕووداو دێت و stream دواتر بە شێوەی ئاسایی دادەخرێت:

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

ئەو شتانەی دەتوانیت پشتیان پێ ببەستیت لە خولی agent دا

چارەسەرکردنی کێشە

کلیل و باڵانسەکەت لە لاپەڕەی Keys & usage دان. Keys & usage