بازدان بۆ ناوەڕۆک
Anthropic

Anthropic

POST /v1/messages داواکارییەک بە فۆرماتی Anthropic Messages وەردەگرێت و بە هەمان فۆرمات وەڵام دەداتەوە، بە streaming یان بێ. لەگەڵ SDK ی Anthropic و ئەو ئامرازانەی لەسەری دروست کراون وەک Claude Code بەکاری بهێنە: base URL دیاری بکە، کلیلی API ی Shannon ـەکەت بەکاربهێنە و id ی مۆدێلێکی Shannon ناو ببە.

POST https://api.shannon-ai.com/v1/messages

SDK ی Anthropic بخەرە سەر base URL ی Shannon. SDK /v1/messages زیاد دەکات و کلیلەکەت لە header ی x-api-key دا دەنێرێت.

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com",
)

message = client.messages.create(
    model="shannon-3",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

وەڵامەکە نامەیەکە کە content ـەکەی لیستێکە لە block. block ەکان بە type ـەکەیان بدۆزەرەوە: کاتێک مۆدێلەکە بیری کردووەتەوە، یەکەم block thinking ە و دەقەکە دوای ئەوە دێت.

200 JSON
{
  "id": "msg_5f0c1e7a9b3d4c62a8e1f07d2b46c9a3",
  "type": "message",
  "role": "assistant",
  "model": "shannon-3",
  "content": [
    {
      "type": "thinking",
      "thinking": "The user wants a greeting in one sentence. Keep it short and friendly."
    },
    {
      "type": "text",
      "text": "Hello, it is good to meet you."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 1184,
    "output_tokens": 46
  }
}

Header ەکان

Header بەها وەسف
x-api-key YOUR_API_KEY کلیلی API ـەکەت. Authorization: Bearer YOUR_API_KEY لە جێی ئەمە قبوڵ دەکرێت.
content-type application/json پێویستە.
anthropic-version 2023-06-01 قبوڵ دەکرێت، پێویست نییە. SDK ی Anthropic 2023-06-01 دەنێرێت؛ وەڵامەکە هەمان فۆرماتی هەیە بە هەر بەهایەک.
anthropic-beta قبوڵ دەکرێت، پێویست نییە.
x-request-id ئارەزوومەندانە. id ی خۆت بۆ داواکارییەکە. لە وەڵامەکەدا وەک خۆی دەگەڕێتەوە؛ بەبێ ئەمە وەڵامەکە id ێکی 12 پیتی هەژدەیی هەڵدەگرێت.

Field ەکانی داواکاری

تەنها messages پێویستە. ستوونی جێبەجێکراو لەلایەن ئەو مۆدێلانە ناو دەبات کە field ەکە وەڵامەکەیان تێدا دەگۆڕێت. مۆدێلە open-weight هۆستکراوەکان دوانزە id ی لیستی مۆدێلەکانن؛ بنەماڵەی Shannon 3 بریتییە لە shannon-3 و shannon-3-pro و shannon-3.1 و shannon-3.1-pro. مۆدێل و نرخ

Field جۆر بنەڕەتی وەسف جێبەجێکراو لەلایەن
model string shannon-1.6-lite id ی مۆدێلێکی Shannon لە لیستی مۆدێلەکان. لەگەڵ هەموو داواکارییەک بینێرە. هاوتاکردن هەستیار نییە بە گەورەیی و بچووکیی پیت. هەر ناوێکی تر 400 unknown model دەگەڕێنێتەوە، بۆیە ئامرازێک کە ناوی مۆدێلی خۆی دەنێرێت دەبێت لەسەر id ی Shannon ڕێک بخرێت. هەموو مۆدێلەکان
messages array پێویستە. گفتوگۆکە، کۆنترین نامە لە سەرەتاوە، لەگەڵ ڕۆڵەکانی user و assistant. لە خوارەوە Messages و content block ەکان ببینە. هەموو مۆدێلەکان
system string | array ڕێنمایی بۆ مۆدێلەکە: ڕیزبەندێکی دەق، یان array ێک لە block ی دەق. لە خوارەوە System prompt ببینە. مۆدێلە open-weight هۆستکراوەکان، shannon-1.6-*، shannon-2-*، shannon-coder-1
max_tokens integer 4096 سنووری سەرەوەی وەڵامەکە، بە تۆکن. لەم endpoint ەدا ئارەزوومەندانەیە؛ SDK ی Anthropic هەمیشە دەینێرێت. بەهایەک لە دەرەوەی 1 تا 65,536 دەخرێتە ناو ئەو مەودایە. هەروەها ئەو بڕەیە کە تا کاتی کارکردنی داواکارییەکە لە باڵانسەکەت پاشەکەوت دەکرێت. مۆدێلە open-weight هۆستکراوەکان، shannon-1.6-lite، shannon-1.6-pro، shannon-coder-1
stream boolean false true وەڵامەکە وەک server-sent events دەنێرێت. لە خوارەوە Streaming ببینە. هەموو مۆدێلەکان
temperature number پلەی گەرمی sampling. لەسەر مۆدێلە open-weight هۆستکراوەکان بەهاکان لە نێوان 0 و 2 دەهێڵرێنەوە. مۆدێلە open-weight هۆستکراوەکان، shannon-1.6-lite، shannon-1.6-pro، shannon-coder-1
top_p number Nucleus sampling. مۆدێلە open-weight هۆستکراوەکان
stop_sequences array تا 4 ڕیزبەندی دەق. وەڵامەکە پێش یەکەمیان کە دەردەکەوێت کۆتایی دێت. stop_reason وەک end_turn دەمێنێتەوە. مۆدێلە open-weight هۆستکراوەکان
tools array ئەو ئامرازانەی مۆدێلەکە دەتوانێت بانگیان بکات، هەریەکە وەک {"name", "description", "input_schema"}. لە خوارەوە Tools ببینە. هەموو مۆدێلەکان
tool_choice object {"type": "auto"} ڕێ دەدات مۆدێلەکە بڕیار بدات، {"type": "any"} ناچاری دەکات ئامرازێک بانگ بکات، {"type": "tool", "name": "…"} ناچاری دەکات ئەو ئامرازە بانگ بکات. مۆدێلە open-weight هۆستکراوەکان
thinking object مۆدێلەکە چەند بیر دەکاتەوە پێش ئەوەی وەڵام بداتەوە. لە خوارەوە Thinking ببینە. مۆدێلە open-weight هۆستکراوەکان
web_search boolean false زیادکراوێکی Shannon بۆ فۆرماتەکە: true ڕێ دەدات مۆدێلەکە پێش وەڵامدانەوە لە وێب بگەڕێت. shannon-1.6-*، shannon-2-*، بنەماڵەی Shannon 3

بێ max_tokens بەهاکە 4,096 ە، و لەسەر shannon-coder-1 65,536.

نیشانەکانی metadata و top_k و service_tier و cache_control لەسەر block ەکان قبوڵ دەکرێن تا کۆدی کلاینتی هەبوو بێ گۆڕانکاری کار بکات. وەڵامەکە ناگۆڕن؛ prompt caching لەسەر مۆدێلە open-weight هۆستکراوەکان خۆکارە.

وەڵامی JSON بەپێی schema لەسەر Chat Completions بە response_format و لەسەر Responses بە text.format داوا دەکرێت. Derketinên strukturkirî

داواکارییەک لەگەڵ system prompt و thinking

ئەم داواکارییە system prompt و بودجەی thinking و temperature و stop sequence دەنێرێت. مۆدێلێکی open-weight ی هۆستکراو بەکاردەهێنێت، کە هەموویان جێبەجێ دەکات.

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com",
)

message = client.messages.create(
    model="DeepSeek-V4-Flash-0731-W4A16-AUTOROUND-REAP",
    max_tokens=4096,
    system="You are a physics teacher. Answer in two sentences.",
    thinking={"type": "enabled", "budget_tokens": 2048},
    temperature=0.3,
    stop_sequences=["\n\n"],
    messages=[{"role": "user", "content": "Why is the sky blue?"}],
)

for block in message.content:
    if block.type == "thinking":
        print("reasoning:", block.thinking)
    elif block.type == "text":
        print("answer:", block.text)
print(message.usage)

لەسەر مۆدێلە open-weight هۆستکراوەکان usage ئەو تۆکنانەی لە prompt cache خوێندراونەتەوە بە جیا لە تۆکنەکانی input ی تر ڕاپۆرت دەکات.

200 JSON
{
  "usage": {
    "input_tokens": 31,
    "cache_read_input_tokens": 0,
    "cache_creation_input_tokens": 0,
    "output_tokens": 62
  }
}

System prompt

system ڕیزبەندێکی دەقە، یان array ێکی block ی دەق بەم شێوەیە [{"type": "text", "text": "…"}]. دەقی block ەکان بە هێڵی نوێ بەیەکەوە دەلکێنرێن.

مۆدێلە open-weight هۆستکراوەکان و shannon-1.6-lite و shannon-1.6-pro و shannon-2-lite و shannon-2-pro و shannon-coder-1 جێبەجێی دەکەن. لەگەڵ id ی بنەماڵەی Shannon 3، ئەو ڕێنماییانەی دەبێت بمێنن بخەرە ناو نامەی بەکارهێنەر.

نامەکان و content block ـەکان

نامەیەک role ێکی هەیە، user یان assistant، و content ێک. content ڕیزبەندێکی دەقە، یان array ێک لە block.

Block وەسف بەردەستە لەسەر
{"type": "text", "text": "…"} دەق. هەموو مۆدێلەکان
{"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "…"}}
{"type": "image", "source": {"type": "url", "url": "…"}}
وێنەیەک لە نامەیەکی user دا، وەک base64 یان بە URL. بنەماڵەی Shannon 3، shannon-1.6-lite، shannon-1.6-pro، و ئەو مۆدێلە open-weight هۆستکراوانەی input ی وێنە لیست دەکەن
{"type": "document", "source": {"type": "base64", "media_type": "application/pdf", "data": "…"}} دۆکیومێنتێک (PDF یان Word یان PowerPoint یان Excel) لە نامەیەکی user دا، وەک base64 یان بە URL. بنەماڵەی Shannon 3
{"type": "tool_use", "id": "toolu_…", "name": "…", "input": {…}} لە نامەی assistant دا: بانگکردنی ئامرازێک کە مۆدێلەکە لە وەڵامێکی پێشوودا ئەنجامی داوە. هەموو مۆدێلەکان
{"type": "tool_result", "tool_use_id": "toolu_…", "content": "…"} لە نامەی user دا: ئەنجامی ئەو بانگکردنە. content ڕیزبەندێکی دەقە، یان لیستێک لە block ی دەق. هەموو مۆدێلەکان

دەتوانیت content ی وەڵامێکی پێشوو وەک خۆی بنێریتەوە: block ی text و tool_use دەخوێندرێنەوە، block ی thinking بازدەدرێن.

لەسەر ئاستەکانی Shannon وێنە و دۆکیومێنت لە دوایین نامەی user دەخوێندرێنەوە. قەبارە و سنوورەکان لاپەڕەی تایبەتی خۆیان هەیە. وێنە و فایلەکان

Thinking

مۆدێلە open-weight هۆستکراوەکان thinking دەکەن بە ئاستی بیرکردنەوە. بێ ئەم field ە ئاستەکە بەرزە.

شێوە budget_tokens کاریگەری
{"type": "disabled"} بێ بیرکردنەوە. وەڵامەکە block ی thinking ی نییە.
{"type": "enabled", "budget_tokens": 2048} ≤ 2,048 ئاستی نزم.
{"type": "enabled", "budget_tokens": 8192} ≤ 8,192 ئاستی ناوەند.
{"type": "enabled", "budget_tokens": 16000} > 8,192 ئاستی بەرز.

مۆدێلێک کە بیر دەکاتەوە بیرکردنەوەکەی وەک block ێکی {"type": "thinking", "thinking": "…"} پێش دەقەکە دەگەڕێنێتەوە. ئاستەکانی Shannon کە بیر دەکەنەوە ئەویش دەنێرن.

ئاستەکان لە لاپەڕەی تایبەتی خۆیان وەسف کراون. ئاستی بیرکردنەوە

Tools

ئامراز فەنکشنێکە کە کۆدەکەت جێبەجێی دەکات. هەریەکە بە name و description و input_schema وەسف بکە. کاتێک مۆدێلەکە ئامرازێکی دەوێت، وەڵامەکە block ێکی tool_use ی تێدایە و stop_reason یەکسانە بە tool_use.

پێناسەی ئامرازێک لە tools دا:

tools
[
  {
    "name": "get_weather",
    "description": "Current weather for a city.",
    "input_schema": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        }
      },
      "required": [
        "city"
      ]
    }
  }
]

content ی وەڵامێک کە بانگی دەکات:

200 content
[
  {
    "type": "text",
    "text": ""
  },
  {
    "type": "tool_use",
    "id": "toolu_3d9a7c1e5b2f4a60c8e1d7f09b24a6c5",
    "name": "get_weather",
    "input": {
      "city": "Paris"
    }
  }
]

ئامرازەکە جێبەجێ بکە، پاشان داواکارییەکە دووبارە بنێرەرەوە لەگەڵ بانگکردنەکە و block ێکی tool_result کە بۆ messages زیاد کراوە:

messages
[
  {
    "role": "user",
    "content": "What is the weather in Paris?"
  },
  {
    "role": "assistant",
    "content": [
      {
        "type": "tool_use",
        "id": "toolu_3d9a7c1e5b2f4a60c8e1d7f09b24a6c5",
        "name": "get_weather",
        "input": {
          "city": "Paris"
        }
      }
    ]
  },
  {
    "role": "user",
    "content": [
      {
        "type": "tool_result",
        "tool_use_id": "toolu_3d9a7c1e5b2f4a60c8e1d7f09b24a6c5",
        "content": "{\"temperature_c\": 18, \"sky\": \"cloudy\"}"
      }
    ]
  }
]

tool_choice

شێوە کاریگەری جێبەجێکراو لەلایەن
{"type": "auto"} مۆدێلەکە بڕیار دەدات ئامرازێک بانگ بکات یان نا. ئەمە بنەڕەتییە. هەموو مۆدێلەکان
{"type": "any"} مۆدێلەکە دەبێت یەکێک لە ئامرازەکان بانگ بکات. مۆدێلە open-weight هۆستکراوەکان
{"type": "tool", "name": "…"} مۆدێلەکە دەبێت ئەو ئامرازە ناودیارکراوە بانگ بکات. مۆدێلە open-weight هۆستکراوەکان

تەنها ئامرازەکانی خاوەن input_schema دەخوێندرێنەوە. گەڕانی وێب لەم endpoint ەدا ئامراز نییە: field ی web_search دیاری بکە.

خولگەی ئامراز بە تەواوی لە لاپەڕەی تایبەتی خۆی وەسف کراوە. Bangkirina fonksiyonê

وەڵامەکە

Field جۆر وەسف نێردراو لەلایەن
id string msg_ و دوای ئەوە 32 پیتی هەژدەیی. هەموو مۆدێلەکان
type string هەمیشە message. هەموو مۆدێلەکان
role string هەمیشە assistant. هەموو مۆدێلەکان
model string id ی بنەڕەتیی ئەو مۆدێلەی وەڵامی دایەوە. هەموو مۆدێلەکان
content array block ەکانی وەڵامەکە، بەم ڕیزبەندییە: thinking کاتێک مۆدێلەکە بیری کردووەتەوە، text، پاشان یەک tool_use بۆ هەر بانگکردنێکی ئامراز. هەموو مۆدێلەکان
stop_reason string بۆچی وەڵامەکە کۆتایی هات. بەهاکانی خوارەوە ببینە. هەموو مۆدێلەکان
usage object input_tokens و output_tokens. هەموو مۆدێلەکان
sources array تەنها لەسەر داواکارییەک بە web_search: true کە گەڕانەکەی شتێکی دۆزیبێتەوە: ئەو ئەنجامانەی درانە مۆدێلەکە، هەریەکەیان لەگەڵ index، title و url. [1] لە وەڵامەکەدا ئەو تۆمارەیە کە index ـەکەی 1 ە. لە stream دا لەگەڵ ڕووداوی message_delta دێت. shannon-1.6-*، shannon-2-*، بنەماڵەی Shannon 3
usage.cache_read_input_tokens integer cache_read_input_tokens ئەو بەشەی prompt ە کە لە cache خوێندراوەتەوە؛ input_tokens ئەوی ترە. cache_creation_input_tokens هەمیشە 0 ە. مۆدێلە open-weight هۆستکراوەکان

Block ەکانی وەڵام

Block وەسف
{"type": "thinking", "thinking": "…"} بیرکردنەوەی مۆدێلەکە. ئەندامی signature بوونی نییە.
{"type": "text", "text": "…"} دەقی وەڵامەکە. دەتوانێت بەتاڵ بێت کاتێک وەڵامەکە بانگکردنی ئامرازێکە.
{"type": "tool_use", "id": "toolu_…", "name": "…", "input": {…}} بانگکردنی ئامرازێک. input ئۆبجێکتێکی JSON ە. ئەنجامەکە بە هەمان id بنێرەرەوە.

stop_reason

stop_reason وەسف نێردراو لەلایەن
end_turn مۆدێلەکە وەڵامەکەی تەواو کرد، یان یەکێک لە stop_sequences ـەکانت دەرکەوت. هەموو مۆدێلەکان
tool_use وەڵامەکە یەک یان چەند بانگکردنی ئامرازی تێدایە. هەموو مۆدێلەکان
max_tokens وەڵامەکە لە سنووری output دا بڕدرا. بنەماڵەی Shannon 3، shannon-1.6-lite، shannon-1.6-pro، shannon-coder-1، لە streamەکاندا

Streaming

stream بکە بە true بۆ server-sent events. هەر فرەیمێک هێڵی event: ـێکی هەیە کە ناوی ئیڤێنتەکەی تێدایە و هێڵی data: ـێک کە ئۆبجێکتێکی JSON ە و ناوەکە لە type دا دووبارە دەکاتەوە. یارمەتیدەرەکانی stream ی SDK ی Anthropic ئەم ئیڤێنتانە بۆ تۆ دەخوێننەوە:

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com",
)

with client.messages.stream(
    model="shannon-3",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain server-sent events in three sentences."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
    message = stream.get_final_message()

print()
print(message.stop_reason, message.usage)

ئیڤێنتەکان، بەو ڕیزبەندییەی دەگەن:

Event داتا کەی
message_start message هەمیشە یەکەمە. message id و ڕۆڵ و مۆدێل و content ێکی بەتاڵ و usage ێکی تێدایە کە لە سفرەوە دەست پێدەکات.
content_block_start index, content_block block ێک دەکرێتەوە. content_block block ێکی بەتاڵی text یان thinking ە، یان block ێکی tool_use لەگەڵ id و name ـەکەی.
content_block_delta index, delta {"type": "thinking_delta", "thinking"} پارچەیەک لە بیرکردنەوەکە، بۆ block ی thinking.
content_block_delta index, delta {"type": "text_delta", "text"} پارچەیەک لە وەڵامەکە، بۆ block ی text.
content_block_delta index, delta {"type": "input_json_delta", "partial_json"} ئارگیومێنتەکانی بانگکردنی ئامرازێک، تەواو لە یەک delta دا، بۆ block ی tool_use.
content_block_stop index ئەو block ـەی ئەم index ـەی هەیە تەواو بوو.
message_delta delta {stop_reason, stop_sequence}, usage کۆتایی وەڵامەکە: delta.stop_reason، و usage ی داواکارییەکە.
message_stop هەمیشە کۆتاییە.

block ەکان بە index ژمارە دەکرێن بەپێی ئەو ڕیزبەندییەی دەکرێنەوە، و یەک block تەواو دەبێت پێش ئەوەی ئەوی دواتر بکرێتەوە. هەر block بەپێی جۆرەکەی بخوێنەوە نەک بەپێی ژمارەکەی: stream دەتوانێت سەرەتا block ێکی text ی بەتاڵ بکاتەوە، پاشان block ی thinking، و وەڵامەکە لە block ێکی text ی دواتردا بگەیەنێت.

200 text/event-stream
event: message_start
data: {"type":"message_start","message":{"id":"msg_5f0c…","type":"message","role":"assistant","model":"shannon-3","content":[],"usage":{"input_tokens":0,"output_tokens":0}}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_stop
data: {"type":"content_block_stop","index":0}

event: content_block_start
data: {"type":"content_block_start","index":1,"content_block":{"type":"thinking","thinking":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":1,"delta":{"type":"thinking_delta","thinking":"Three sentences: what it is, how it is framed, why it is used."}}

event: ping
data: {"type": "ping"}

event: content_block_stop
data: {"type":"content_block_stop","index":1}

event: content_block_start
data: {"type":"content_block_start","index":2,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":2,"delta":{"type":"text_delta","text":"Server-sent events let a server push text over one HTTP reply."}}

event: content_block_stop
data: {"type":"content_block_stop","index":2}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":1190,"output_tokens":84}}

event: message_stop
data: {"type":"message_stop"}

Keep-alive

نێردراو لەلایەن وەسف
بنەماڵەی Shannon 3، shannon-1.6-lite، shannon-1.6-pro، shannon-coder-1 ئیڤێنتی ping لەگەڵ داتای {"type": "ping"}، هەر 15 چرکە جارێک.
مۆدێلە open-weight هۆستکراوەکان هێڵی لێدوانی : keepalive، هەر 15 چرکە جارێک لە کاتی کارکردنی مۆدێلەکە.

stream ێک کە شکست دەخوات

شکستێک دوای دەستپێکردنی stream ئیڤێنتێکی error ە بە هەمان body ی وەڵامی هەڵە: {"type": "error", "error": {"type", "message"}}. ئیڤێنتەکانی کۆتایی، message_delta و message_stop، هێشتا دواتر دێن. وەڵامەکە وەک شکستخواردوو حیساب بکە و داواکارییەکە دووبارە بنێرەرەوە.

هەڵەکان

هەڵەکان جەستەی هەڵەی Anthropic بەکاردەهێنن: type یەکسانە بە error، و ئۆبجێکتی error یەک type و یەک message ی تێدایە. خشتەکە ئەوە لیست دەکات کە ئەم endpoint ە زۆرتر دەیگەڕێنێتەوە. لیستی تەواو، لەگەڵ ئەوەی کامیان دووبارە بکرێتەوە، لاپەڕەی تایبەتی خۆی هەیە. Çewtî

400 JSON
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "unknown model: no-such-model"
  }
}
دۆخ جۆر نامە کەی
401 authentication_error Missing authentication
Invalid API key
هیچ کلیلێکی API نەنێردراوە، یان کلیلەکە نەناسراوە یان هەڵوەشێنراوەتەوە.
400 invalid_request_error unknown model: <id> model id ی مۆدێلێکی Shannon نییە.
400 invalid_request_error No user message provided ئاستەکانی Shannon: داواکارییەکە دەقی بەکارهێنەری تێدا نییە و tools ی نییە.
400 invalid_request_error <id> does not accept image input وێنەیەک نێردرا بۆ مۆدێلێکی open-weight ی هۆستکراو کە پشتگیری input ی وێنە ناکات.
422 invalid_request_error Failed to deserialize the JSON body into the target type: … messages بوونی نییە، یان field ێک جۆری JSON ی هەڵەی هەیە.
429 rate_limit_error Quota exceeded. Upgrade your plan at shannon-ai.com/plan max_tokens گەورەترە لەو بڕەی لە باڵانسەکەت ماوەتەوە.
429 rate_limit_error Too many requests. Retry in <n>s. Flood protection: زیاتر لە 120 داواکاری لە یەک خولەکدا لەسەر هەژمارەکەت.
429 rate_limit_error Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan shannon-coder-1: بانگکردنەکانی Shannon Coder ی پلانەکەت بۆ پەنجەرەی 4 کاتژمێری ئێستا تەواو بوون.
500 server_error The model backend failed to answer. Please retry. مۆدێلەکە وەڵامی دروست نەکرد. داواکارییەکە دووبارە بنێرەرەوە.
502 api_error The model backend failed to answer. Please retry. مۆدێلەکە وەڵامی دروست نەکرد. داواکارییەکە دووبارە بنێرەرەوە.

ژماردنی تۆکنەکان

POST /v1/messages/count_tokens هەمان body ی داواکاری نامە وەردەگرێت (model، system، messages، tools) و {"input_tokens": n} دەگەڕێنێتەوە: ژمارەی تۆکنەکانی input ی کە لەسەر داواکارییەکە حیساب دەکرێت. بۆ مۆدێلە open-weight هۆستکراوەکان دەژمێردرێت، بێبەرامبەرە و لەلایەن flood protection ـەوە ناژمێردرێت.

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com",
)

count = client.messages.count_tokens(
    model="DeepSeek-V4-Flash-0731-W4A16-AUTOROUND-REAP",
    system="You are a physics teacher. Answer in two sentences.",
    messages=[{"role": "user", "content": "Why is the sky blue?"}],
)

print(count.input_tokens)

ژماردن لاپەڕەی تایبەتی خۆی هەیە، لەگەڵ endpoint ی دەقی سادە و سنوورەکان. هەژمارکردنی تۆکن