Chat Completions

POST https://api.shannon-ai.com/v1/chat/completions

Is é an t-iarratas is lú id múnla agus teachtaireacht úsáideora amháin.

from openai import OpenAI

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

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

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.shannon-ai.com/v1",
});

const response = await client.chat.completions.create({
  model: "shannon-3",
  messages: [{ role: "user", content: "Say hello in one sentence." }],
});

console.log(response.choices[0].message.content);

curl https://api.shannon-ai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-3",
    "messages": [{"role": "user", "content": "Say hello in one sentence."}]
  }'

Is réad JSON amháin an freagra:

{
  "id": "chatcmpl-5f0c1e7a9b3d4c62a8e1f07d2b46c9a3",
  "object": "chat.completion",
  "created": 1791625200,
  "model": "shannon-3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello, it is good to meet you.",
        "reasoning_content": "The user wants a greeting in one sentence. Keep it short and friendly."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1184,
    "completion_tokens": 46,
    "total_tokens": 1230
  }
}

Ceanntásca

Ceanntásca iarratais

Ceanntásca freagra

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

Glactar le réimsí OpenAI eile, mar n, user, stream_options, parallel_tool_calls, presence_penalty, frequency_penalty, logit_bias, logprobs, metadata, store agus prompt_cache_key, ionas go ritheann cód cliant atá ann cheana gan athrú. Ní athraíonn siad an freagra: tá rogha amháin ann i gcónaí, agus críochnaíonn sruth i gcónaí le húsáid.

Filleann réimse le cineál JSON mícheart, mar shampla "max_tokens": "100", 422. Mar an gcéanna le hiarratas gan messages.

Tá leathanach dá gcuid féin ag uirlisí, aschur struchtúrtha, réasúnaíocht agus cuardach gréasáin: Glaonna Feidhme, Aschuir Struchtúrtha, Iarracht réasúnaíochta, Insuite i Cuardach Gréasáin.

Iarratas le roghanna

Socraíonn an t-iarratas seo teachtaireacht chórais, na réimsí samplála agus an iarracht réasúnaíochta. Úsáideann sé múnla open-weight óstáilte, a chuireann iad uile i bhfeidhm.

from openai import OpenAI

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

response = client.chat.completions.create(
    model="DeepSeek-V4-Flash-0731-W4A16-AUTOROUND-REAP",
    messages=[
        {"role": "system", "content": "You are a physics teacher. Answer in two sentences."},
        {"role": "user", "content": "Why is the sky blue?"},
    ],
    max_tokens=512,
    temperature=0.3,
    top_p=0.9,
    seed=7,
    stop=["\n\n"],
    reasoning_effort="low",
)

message = response.choices[0].message
print(message.reasoning_content)  # the reasoning
print(message.content)            # the answer
print(response.usage)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.shannon-ai.com/v1",
});

const response = await client.chat.completions.create({
  model: "DeepSeek-V4-Flash-0731-W4A16-AUTOROUND-REAP",
  messages: [
    { role: "system", content: "You are a physics teacher. Answer in two sentences." },
    { role: "user", content: "Why is the sky blue?" },
  ],
  max_tokens: 512,
  temperature: 0.3,
  top_p: 0.9,
  seed: 7,
  stop: ["\n\n"],
  reasoning_effort: "low",
});

const message = response.choices[0].message;
console.log(message.reasoning_content); // the reasoning
console.log(message.content);           // the answer
console.log(response.usage);

curl https://api.shannon-ai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "DeepSeek-V4-Flash-0731-W4A16-AUTOROUND-REAP",
    "messages": [
      {"role": "system", "content": "You are a physics teacher. Answer in two sentences."},
      {"role": "user", "content": "Why is the sky blue?"}
    ],
    "max_tokens": 512,
    "temperature": 0.3,
    "top_p": 0.9,
    "seed": 7,
    "stop": ["\n\n"],
    "reasoning_effort": "low"
  }'

Tá an cruth céanna ar an bhfreagra agus thuas. Cuireann a usage dhá mhionsonra leis ar na múnlaí open-weight óstáilte: na token prompt a léadh ón gcache agus na token a caitheadh ar réasúnaíocht.

{
  "usage": {
    "prompt_tokens": 31,
    "completion_tokens": 62,
    "total_tokens": 93,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 21
    }
  }
}

Fad an aschuir

Déanann max_tokens dhá rud. Ar an gcéad dul síos, is é líon na token a chuirtear i leataobh as d'iarmhéid nuair a thosaíonn an t-iarratas. Nuair a bhíonn an freagra críochnaithe, cuirtear na token a d'úsáid an t-iarratas in ionad an méid sin. Má tá max_tokens níos mó ná an méid atá fágtha de d'iarmhéid, filleann an t-iarratas 429 Quota exceeded fiú dá n-oirfeadh an freagra féin. Seol max_tokens níos ísle chun níos lú a chur i leataobh.

Comhairtear shannon-coder-1 ar bhealach difriúil ar an gcríochphointe seo: is glao Shannon Coder de do phlean gach iarratas, agus ní chuirtear aon token i leataobh dó. Teorainneacha agus iarmhéid

Ar an dara dul síos, cuireann sé teorainn le fad an fhreagra ar na múnlaí seo:

Gan max_tokens ná max_completion_tokens, is é 4,096 an luach. Ar shannon-coder-1 is é 65,536 é.

Teachtaireachtaí

Is réad é gach teachtaireacht le role agus content. Is sreang é content, nó eagar codanna nuair a iompraíonn an teachtaireacht níos mó ná téacs.

Le id de theaghlach Shannon 3, cuir treoracha atá le comhlíonadh isteach sa teachtaireacht user.

Ar leibhéil Shannon filleann iarratas gan téacs úsáideora agus gan tools 400 No user message provided.

Codanna ábhair

Tá leathanach dá gcuid féin ag méideanna, teorainneacha agus an liosta iomlán foirmeacha. Íomhánna agus comhaid

An réad freagra

Cúiseanna críochnaithe

Tuairiscíonn freagra nach sruthaítear stop nó tool_calls.

Úsáid

Ar na múnlaí open-weight óstáilte, is iad prompt_tokens do theachtaireachtaí agus sainmhínithe uirlisí arna gcomhaireamh le tokenizer an mhúnla féin, móide token aon íomhá. Filleann na críochphointí comhairimh token an uimhir chéanna sula seolann tú. Comhaireamh token

Ar leibhéil Shannon, comhaireann prompt_tokens gach rud a léigh an múnla chun an freagra a scríobh, mar sin tá sé níos mó ná téacs do theachtaireachtaí amháin.

Sruthú

Le stream socraithe go true tagann an freagra mar imeachtaí chat.completion.chunk agus críochnaíonn sé le data: [DONE]. Tá finish_reason agus usage sa phíosa deireanach roimhe; ní theastaíonn aon stream_options. Tá leathanach dá gcuid féin ag cruthanna na bpíosaí, línte keep-alive agus earráidí laistigh de shruth. Sruthú

Earráidí

Is réad JSON é earráid le ball error. Ritheann seiceálacha san ord seo: eochair API, corp iarratais, id múnla, ansin iarmhéid. 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

{
  "error": {
    "type": "invalid_request_error",
    "message": "unknown model: no-such-model"
  }
}