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) import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "YOUR_API_KEY",
baseURL: "https://api.shannon-ai.com",
});
const message = await client.messages.create({
model: "shannon-3",
max_tokens: 1024,
messages: [{ role: "user", content: "Say hello in one sentence." }],
});
for (const block of message.content) {
if (block.type === "text") console.log(block.text);
} curl https://api.shannon-ai.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "shannon-3",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Say hello in one sentence."}]
}' وەڵامەکە نامەیەکە کە content ـەکەی لیستێکە لە block. block ەکان بە type ـەکەیان بدۆزەرەوە: کاتێک مۆدێلەکە بیری کردووەتەوە، یەکەم block thinking ە و دەقەکە دوای ئەوە دێت.
{
"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) import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "YOUR_API_KEY",
baseURL: "https://api.shannon-ai.com",
});
const message = await 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 (const block of message.content) {
if (block.type === "thinking") console.log("reasoning:", block.thinking);
if (block.type === "text") console.log("answer:", block.text);
}
console.log(message.usage); curl https://api.shannon-ai.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"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?"}]
}' لەسەر مۆدێلە open-weight هۆستکراوەکان usage ئەو تۆکنانەی لە prompt cache خوێندراونەتەوە بە جیا لە تۆکنەکانی input ی تر ڕاپۆرت دەکات.
{
"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 دا:
[
{
"name": "get_weather",
"description": "Current weather for a city.",
"input_schema": {
"type": "object",
"properties": {
"city": {
"type": "string"
}
},
"required": [
"city"
]
}
}
] content ی وەڵامێک کە بانگی دەکات:
[
{
"type": "text",
"text": ""
},
{
"type": "tool_use",
"id": "toolu_3d9a7c1e5b2f4a60c8e1d7f09b24a6c5",
"name": "get_weather",
"input": {
"city": "Paris"
}
}
] ئامرازەکە جێبەجێ بکە، پاشان داواکارییەکە دووبارە بنێرەرەوە لەگەڵ بانگکردنەکە و block ێکی tool_result کە بۆ 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) import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "YOUR_API_KEY",
baseURL: "https://api.shannon-ai.com",
});
const stream = client.messages.stream({
model: "shannon-3",
max_tokens: 1024,
messages: [{ role: "user", content: "Explain server-sent events in three sentences." }],
});
stream.on("text", (text) => process.stdout.write(text));
const message = await stream.finalMessage();
console.log("\n", message.stop_reason, message.usage); curl -N https://api.shannon-ai.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "shannon-3",
"max_tokens": 1024,
"stream": true,
"messages": [{"role": "user", "content": "Explain server-sent events in three sentences."}]
}' ئیڤێنتەکان، بەو ڕیزبەندییەی دەگەن:
| 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 ی دواتردا بگەیەنێت.
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î
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "unknown model: no-such-model"
}
} | دۆخ | جۆر | نامە | کەی |
|---|---|---|---|
401 | authentication_error | Missing authenticationInvalid 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) import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "YOUR_API_KEY",
baseURL: "https://api.shannon-ai.com",
});
const count = await client.messages.countTokens({
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?" }],
});
console.log(count.input_tokens); curl https://api.shannon-ai.com/v1/messages/count_tokens \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"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?"}]
}'
# {"input_tokens": 31} ژماردن لاپەڕەی تایبەتی خۆی هەیە، لەگەڵ endpoint ی دەقی سادە و سنوورەکان. هەژمارکردنی تۆکن