Léim go dtí an t-ábhar
Formáid Antraipeach

Formáid Antraipeach

Glacann POST /v1/messages iarratas i bhformáid Anthropic Messages agus freagraíonn sé san fhormáid chéanna, sruthaithe nó gan sruthú. Úsáid é leis an SDK Anthropic agus le huirlisí atá tógtha air, mar Claude Code: socraigh an URL bonn, úsáid d'eochair API Shannon agus ainmnigh id múnla Shannon.

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

Díriú an SDK Anthropic ar URL bonn Shannon. Cuireann an SDK /v1/messages leis agus seolann sé d'eochair sa cheanntásc 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)

Is teachtaireacht é an freagra a bhfuil liosta bloc ina content. Aimsigh na bloic de réir a type: nuair a rinne an múnla réasúnaíocht, is é thinking an chéad bhloc agus tagann an téacs ina dhiaidh.

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

Ceanntásca

Ceanntásc Luach Cur síos
x-api-key YOUR_API_KEY D'eochair API. Glactar le Authorization: Bearer YOUR_API_KEY ina háit.
content-type application/json Riachtanach.
anthropic-version 2023-06-01 Glactar leis, ní riachtanach. Seolann an SDK Anthropic 2023-06-01; tá an fhormáid chéanna ar an bhfreagra cibé luach a bheidh ann.
anthropic-beta Glactar leis, ní riachtanach.
x-request-id Roghnach. D'id féin don iarratas. Filleann sé gan athrú ar an bhfreagra; gan é, tá id de 12 charachtar heicsidheachúlacha ar an bhfreagra.

Réimsí an iarratais

Ní theastaíonn ach messages. Ainmníonn an colún Curtha i bhfeidhm ag na múnlaí ar a n-athraíonn réimse an freagra. Is iad na múnlaí open-weight óstáilte an dá id dhéag de liosta na múnlaí; is é teaghlach Shannon 3 shannon-3, shannon-3-pro, shannon-3.1 agus shannon-3.1-pro. Múnlaí agus praghsáil

Réimse Cineál Réamhshocrú Cur síos Curtha i bhfeidhm ag
model string shannon-1.6-lite Id múnla Shannon ó liosta na múnlaí. Seol é le gach iarratas. Ní thugtar aird ar chás na litreacha. Filleann aon ainm eile 400 unknown model, mar sin caithfear uirlis a sheolann a hainmneacha múnla féin a shocrú go id Shannon. Gach múnla
messages array Riachtanach. An comhrá, an teachtaireacht is sine ar dtús, leis na róil user agus assistant. Féach Teachtaireachtaí agus bloic ábhair thíos. Gach múnla
system string | array Treoracha don mhúnla: sreang, nó eagar bloc téacs. Féach Prompt córais thíos. Múnlaí open-weight óstáilte, shannon-1.6-*, shannon-2-*, shannon-coder-1
max_tokens integer 4096 Uasteorainn an fhreagra, i token. Roghnach ar an gcríochphointe seo; seolann an SDK Anthropic i gcónaí é. Aistrítear luach lasmuigh de 1 go 65,536 isteach san raon sin. Is é freisin an méid a chuirtear i leataobh as d'iarmhéid agus an t-iarratas ag rith. Múnlaí open-weight óstáilte, shannon-1.6-lite, shannon-1.6-pro, shannon-coder-1
stream boolean false Seolann true an freagra mar imeachtaí a sheoltar ón bhfreastalaí. Féach Sruthú thíos. Gach múnla
temperature number Teocht samplála. Ar na múnlaí open-weight óstáilte coimeádtar luachanna idir 0 agus 2. Múnlaí open-weight óstáilte, shannon-1.6-lite, shannon-1.6-pro, shannon-coder-1
top_p number Samplail núicléis. Múnlaí open-weight óstáilte
stop_sequences array Suas le 4 shreang. Críochnaíonn an freagra roimh an gcéad cheann a thagann chun cinn. Fanann stop_reason mar end_turn. Múnlaí open-weight óstáilte
tools array Na huirlisí a fhéadfaidh an múnla a ghlaoch, gach ceann mar {"name", "description", "input_schema"}. Féach Uirlisí thíos. Gach múnla
tool_choice object Ligeann {"type": "auto"} don mhúnla cinneadh a dhéanamh, cuireann {"type": "any"} iachall air uirlis a ghlaoch, cuireann {"type": "tool", "name": "…"} iachall air an uirlis sin a ghlaoch. Múnlaí open-weight óstáilte
thinking object Cé mhéad a réasúnaíonn an múnla sula bhfreagraíonn sé. Féach Smaointeoireacht thíos. Múnlaí open-weight óstáilte
web_search boolean false Breisiú Shannon ar an bhformáid: ligeann true don mhúnla cuardach a dhéanamh ar an ngréasán sula bhfreagraíonn sé. shannon-1.6-*, shannon-2-*, teaghlach Shannon 3

Gan max_tokens is é 4,096 an luach, agus 65,536 ar shannon-coder-1.

Glactar le marcóirí metadata, top_k, service_tier agus cache_control ar bhloic ionas go ritheann cód cliant atá ann cheana gan athrú. Ní athraíonn siad an freagra; tá cacheáil prompt ar na múnlaí open-weight óstáilte uathoibríoch.

Iarrtar freagra JSON de réir scéime le response_format ar Chat Completions agus le text.format ar Responses. Aschuir Struchtúrtha

Iarratas le prompt córais agus smaointeoireacht

Seolann an t-iarratas seo prompt córais, buiséad smaointeoireachta, teocht agus seicheamh stoptha. Úsáideann sé múnla open-weight óstáilte, a chuireann iad uile i bhfeidhm.

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)

Ar na múnlaí open-weight óstáilte tuairiscíonn usage na token a léadh ón gcache prompt scartha ó na token ionchuir eile.

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

Prompt córais

Is sreang é system, nó eagar bloc téacs san fhoirm [{"type": "text", "text": "…"}]. Nasctar téacsanna na mbloc le briseadh líne.

Cuireann na múnlaí open-weight óstáilte, shannon-1.6-lite, shannon-1.6-pro, shannon-2-lite, shannon-2-pro agus shannon-coder-1 i bhfeidhm é. Le id de theaghlach Shannon 3, cuir treoracha atá le comhlíonadh isteach sa teachtaireacht úsáideora.

Teachtaireachtaí agus bloic ábhair

Tá role ag teachtaireacht, user nó assistant, agus content. Is sreang é content, nó eagar bloc.

Bloc Cur síos Ar fáil ar
{"type": "text", "text": "…"} Téacs. Gach múnla
{"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "…"}}
{"type": "image", "source": {"type": "url", "url": "…"}}
Íomhá i dteachtaireacht user, mar base64 nó trí URL. Teaghlach Shannon 3, shannon-1.6-lite, shannon-1.6-pro, agus na múnlaí open-weight óstáilte a liostaíonn ionchur íomhá
{"type": "document", "source": {"type": "base64", "media_type": "application/pdf", "data": "…"}} Doiciméad (PDF, Word, PowerPoint nó Excel) i dteachtaireacht user, mar base64 nó trí URL. Teaghlach Shannon 3
{"type": "tool_use", "id": "toolu_…", "name": "…", "input": {…}} I dteachtaireacht assistant: glao uirlise a rinne an múnla i bhfreagra níos luaithe. Gach múnla
{"type": "tool_result", "tool_use_id": "toolu_…", "content": "…"} I dteachtaireacht user: toradh an ghlaoigh sin. Is sreang é content, nó liosta bloc téacs. Gach múnla

Is féidir leat content freagra níos luaithe a sheoladh ar ais mar atá: léitear bloic text agus tool_use, scipeáiltear bloic thinking.

Ar leibhéil Shannon léitear íomhánna agus doiciméid ón teachtaireacht user dheireanach. Tá leathanach dá gcuid féin ag méideanna agus teorainneacha. Íomhánna agus comhaid

Smaointeoireacht

Mapálann na múnlaí open-weight óstáilte thinking go hiarracht réasúnaíochta. Gan an réimse is ard an iarracht.

Foirm budget_tokens Éifeacht
{"type": "disabled"} Gan réasúnaíocht. Níl aon bhloc thinking sa fhreagra.
{"type": "enabled", "budget_tokens": 2048} ≤ 2,048 Iarracht íseal.
{"type": "enabled", "budget_tokens": 8192} ≤ 8,192 Iarracht mheánach.
{"type": "enabled", "budget_tokens": 16000} > 8,192 Iarracht ard.

Seolann múnla a dhéanann réasúnaíocht a réasúnaíocht ar ais mar bhloc {"type": "thinking", "thinking": "…"} os comhair an téacs. Seolann na leibhéil Shannon a dhéanann réasúnaíocht é freisin.

Déantar cur síos ar na hiarrachtaí ar a leathanach féin. Iarracht réasúnaíochta

Uirlisí

Is feidhm é uirlis a ritheann do chód. Déan cur síos ar gach ceann le name, description agus input_schema. Nuair a theastaíonn uirlis ón múnla, tá bloc tool_use sa fhreagra agus is é tool_use an stop_reason.

Sainmhíniú uirlise in tools:

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

content freagra a ghlaonn í:

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

Rith an uirlis, ansin seol an t-iarratas arís agus an glao agus bloc tool_result curtha le 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

Foirm Éifeacht Curtha i bhfeidhm ag
{"type": "auto"} Socraíonn an múnla an nglaofaidh sé uirlis. Is é seo an réamhshocrú. Gach múnla
{"type": "any"} Caithfidh an múnla ceann de na huirlisí a ghlaoch. Múnlaí open-weight óstáilte
{"type": "tool", "name": "…"} Caithfidh an múnla an uirlis ainmnithe a ghlaoch. Múnlaí open-weight óstáilte

Ní léitear ach uirlisí le input_schema. Ní uirlis é cuardach gréasáin ar an gcríochphointe seo: socraigh an réimse web_search.

Déantar cur síos iomlán ar lúb na n-uirlisí ar a leathanach féin. Glaonna Feidhme

An freagra

Réimse Cineál Cur síos Seolta ag
id string msg_ agus 32 charachtar heicsidheachúlacha ina dhiaidh. Gach múnla
type string message i gcónaí. Gach múnla
role string assistant i gcónaí. Gach múnla
model string An id canónach den mhúnla a d'fhreagair. Gach múnla
content array Bloic an fhreagra, san ord seo: thinking nuair a rinne an múnla réasúnaíocht, text, ansin tool_use amháin in aghaidh gach glao uirlise. Gach múnla
stop_reason string Cén fáth ar tháinig deireadh leis an bhfreagra. Féach na luachanna thíos. Gach múnla
usage object input_tokens agus output_tokens. Gach múnla
sources array Ní bhíonn ann ach ar iarratas a bhfuil web_search: true air agus gur aimsigh a chuardach rud éigin: na torthaí a tugadh don mhúnla, gach ceann le index, title agus url. Is é [1] sa fhreagra an iontráil a bhfuil index 1 aici. I sruth tagann sé leis an imeacht message_delta. shannon-1.6-*, shannon-2-*, teaghlach Shannon 3
usage.cache_read_input_tokens integer Is é cache_read_input_tokens an chuid den prompt a léadh ón gcache; is é input_tokens an chuid eile. Is 0 i gcónaí é cache_creation_input_tokens. Múnlaí open-weight óstáilte

Bloic an fhreagra

Bloc Cur síos
{"type": "thinking", "thinking": "…"} Réasúnaíocht an mhúnla. Níl aon bhall signature ann.
{"type": "text", "text": "…"} Téacs an fhreagra. Is féidir é a bheith folamh nuair is glao uirlise an freagra.
{"type": "tool_use", "id": "toolu_…", "name": "…", "input": {…}} Glao uirlise. Is réad JSON é input. Seol an toradh ar ais leis an id céanna.

stop_reason

stop_reason Cur síos Seolta ag
end_turn Chríochnaigh an múnla a fhreagra, nó tháinig ceann de do stop_sequences chun cinn. Gach múnla
tool_use Tá glao uirlise amháin nó níos mó sa fhreagra. Gach múnla
max_tokens Gearradh an freagra ag an teorainn aschuir. Teaghlach Shannon 3, shannon-1.6-lite, shannon-1.6-pro, shannon-coder-1, i sruthanna

Sruthú

Socraigh stream go true le haghaidh imeachtaí a sheoltar ón bhfreastalaí. I ngach fráma tá líne event: le hainm an imeachta agus líne data: le réad JSON a athdhéanann an t-ainm i type. Léann cabhróirí sruthanna an SDK Anthropic na himeachtaí seo duit:

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)

Na himeachtaí, san ord ina sroicheann siad:

Imeacht Sonraí Cathain
message_start message An chéad cheann i gcónaí. Tá an id, an ról, an múnla, content folamh agus usage a thosaíonn ag nialas i message.
content_block_start index, content_block Osclaítear bloc. Is bloc folamh text nó thinking é content_block, nó bloc tool_use lena id agus name.
content_block_delta index, delta {"type": "thinking_delta", "thinking"} Píosa den réasúnaíocht, do bhloc thinking.
content_block_delta index, delta {"type": "text_delta", "text"} Píosa den fhreagra, do bhloc text.
content_block_delta index, delta {"type": "input_json_delta", "partial_json"} Argóintí glao uirlise, iomlán in delta amháin, do bhloc tool_use.
content_block_stop index Tá an bloc leis an index seo críochnaithe.
message_delta delta {stop_reason, stop_sequence}, usage Deireadh an fhreagra: delta.stop_reason, agus usage an iarratais.
message_stop An ceann deireanach i gcónaí.

Uimhrítear na bloic de réir index san ord ina n-osclaítear iad, agus tá bloc amháin críochnaithe sular osclaítear an chéad cheann eile. Léigh gach bloc de réir a chineáil, ní de réir a uimhreach: is féidir le sruth bloc text folamh a oscailt ar dtús, ansin an bloc thinking, agus an freagra a sheachadadh i mbloc text níos déanaí.

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

Seolta ag Cur síos
Teaghlach Shannon 3, shannon-1.6-lite, shannon-1.6-pro, shannon-coder-1 Imeacht ping leis na sonraí {"type": "ping"}, gach 15 soicind.
Múnlaí open-weight óstáilte Líne tráchta : keepalive, gach 15 soicind agus an múnla ag obair.

Sruth a theipeann

Is imeacht error é teip tar éis don sruth tosú, leis an gcorp céanna le freagra earráide: {"type": "error", "error": {"type", "message"}}. Leanann na himeachtaí deiridh, message_delta agus message_stop, fós. Caith leis an bhfreagra mar theip agus seol an t-iarratas arís.

Earráidí

Úsáideann earráidí corp earráide Anthropic: is é error an type, agus tá type agus message sa réad error. Liostaíonn an tábla an méid a fhilleann an críochphointe seo is minice. Tá leathanach dá chuid féin ag an liosta iomlán, leis an méid ar cheart triail eile a bhaint as. Láimhseáil Earráide

400 JSON
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "unknown model: no-such-model"
  }
}
Stádas Cineál Teachtaireacht Cathain
401 authentication_error Missing authentication
Invalid API key
Níor seoladh aon eochair API, nó tá an eochair anaithnid nó cúlghairthe.
400 invalid_request_error unknown model: <id> Ní id múnla Shannon é model.
400 invalid_request_error No user message provided Leibhéil Shannon: níl aon téacs úsáideora ná tools san iarratas.
400 invalid_request_error <id> does not accept image input Seoladh íomhá chuig múnla open-weight óstáilte gan ionchur íomhá.
422 invalid_request_error Failed to deserialize the JSON body into the target type: … Tá messages ar iarraidh, nó tá cineál JSON mícheart ar réimse.
429 rate_limit_error Quota exceeded. Upgrade your plan at shannon-ai.com/plan Tá max_tokens níos mó ná an méid atá fágtha de d'iarmhéid.
429 rate_limit_error Too many requests. Retry in <n>s. Cosaint tuile: níos mó ná 120 iarratas in aon nóiméad amháin ar do chuntas.
429 rate_limit_error Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan shannon-coder-1: tá glaonna Shannon Coder do phlean na fuinneoige 4 uair an chloig reatha úsáidte.
500 server_error The model backend failed to answer. Please retry. Níor tháirg an múnla freagra. Seol an t-iarratas arís.
502 api_error The model backend failed to answer. Please retry. Níor tháirg an múnla freagra. Seol an t-iarratas arís.

Token a chomhaireamh

Glacann POST /v1/messages/count_tokens an corp céanna le hiarratas teachtaireachta (model, system, messages, tools) agus filleann sé {"input_tokens": n}: líon na token ionchuir a mbeadh muirear orthu don iarratas. Oibríonn sé do na múnlaí open-weight óstáilte, tá sé saor in aisce agus ní chuirtear san áireamh é i gcosaint tuile.

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)

Tá leathanach dá chuid féin ag comhaireamh, leis an gcríochphointe téacs simplí agus na teorainneacha. Comhaireamh token