CLI գործիքներ ծրագրավորման համար

Ծրագրավորման գործիքին Shannon-ի հետ աշխատելու համար պետք են երեք կարգավորում՝ API-ի base URL-ը, ձեր API բանալին և Shannon մոդելի id։ Այս էջը տալիս է ճշգրիտ կարգավորումները Claude Code-ի և Codex CLI-ի համար, բացատրում է, թե ինչպես է հաշվվում shannon-coder-1 ծրագրավորման մոդելը, և թվարկում է այն սխալները, որոնց հանդիպում են այս գործիքները։

Որ գործիքն ինչ endpoint է օգտագործում

Երեք endpoint-ներն էլ ընդունում են նույն API բանալին՝ որպես Authorization: Bearer կամ որպես x-api-key։ Այս գործիքների ուղարկած anthropic-version, anthropic-beta և openai-beta header-ները ընդունվում են։

Ընտրեք Shannon մոդել

Յուրաքանչյուր հարցում պետք է նշի Shannon-ի հրապարակած մոդելի id։ Ծրագրավորման գործիքն ուղարկում է իր սեփական լռելյայն մոդելի անունը, եթե դուք այլ բան չեք ասել, իսկ 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-ն և hosted open-weight մոդելները, ուստի ծրագրավորման գործիքի համար ընտրեք դրանցից մեկը։

Claude Code

Claude Code-ն իր միացումը կարդում է միջավայրի փոփոխականներից։ Սահմանեք դրանք այն shell-ում, որը գործարկում է այն, կամ ~/.claude/settings.json-ի env բլոկում՝ յուրաքանչյուր նիստի համար պահելու նպատակով։

# 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-ները և որոշ հրամաններ մոդելը պահանջում են իր ներկառուցված անվամբ, և յուրաքանչյուր անուն պետք է համապատասխանի Shannon id-ի։
• Օրինակը ֆոնային հարցումները ուղղում է shannon-1.6-lite-ին, որը հաշվվում է թոքեններով։ Այդ դեպքում նիստի վերնագրերը և նմանատիպ հարցումները Coder կանչեր չեն օգտագործում։
• Claude Code-ը POST /v1/messages/count_tokens-ից հարցնում է համատեքստի չափը։ Endpoint-ը աշխատում է hosted open-weight մոդելների համար։ Shannon id-ի դեպքում այն պատասխանում է 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-ը որպես model provider ~/.codex/config.toml-ում, այնտեղ ընտրեք Shannon մոդելի id և ձեր 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-ը ընդունվում է համատեղելիության համար։
• Ֆունկցիոնալ գործիքները (type: "function") առաջարկվում են մոդելին /v1/responses-ում։
• /v1/responses-ում shannon-coder-1-ը հաշվվում է թոքեններով՝ ձեր մնացորդից, ոչ թե Coder կանչերով։

Նույն ստուգումը Responses endpoint-ի համար.

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 ժամը մեկ՝ UTC-ով 00:00-ին, 04:00-ին, 08:00-ին, 12:00-ին, 16:00-ին և 20:00-ին։

Պլանի էջը ցույց է տալիս ընթացիկ թվերը։ Պլաններ

Երբ պատուհանի կանչերը սպառվում են, հարցմանը պատասխանվում է 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"}

Ինչի վրա կարող է հույս դնել գործակալային ցիկլը

Խնդիրների լուծում

Ձեր բանալին և մնացորդը «Բանալիներ և օգտագործում» էջում են։ Բանալիներ և օգտագործում