Chat Completions

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

Najmanji zahtev je id modela i jedna korisnička poruka.

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."}]
  }'

Odgovor je jedan JSON objekat:

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

Zaglavlja

Zaglavlja zahteva

Zaglavlja odgovora

Polja zahteva

Obavezan je samo messages. Kolona Primenjuju navodi modele na kojima polje menja odgovor. Hostovani open-weight modeli su dvanaest id-jeva sa liste modela; porodica Shannon 3 su shannon-3, shannon-3-pro, shannon-3.1 i shannon-3.1-pro. Modeli i cene

Druga OpenAI polja, kao što su n, user, stream_options, parallel_tool_calls, presence_penalty, frequency_penalty, logit_bias, logprobs, metadata, store i prompt_cache_key, prihvataju se da bi postojeći klijentski kod radio nepromenjen. Ne menjaju odgovor: uvek postoji jedan izbor, a stream uvek završava upotrebom.

Polje sa pogrešnim JSON tipom, na primer "max_tokens": "100", vraća 422. Isto važi i za zahtev bez messages.

Alati, strukturirani izlaz, reasoning i web pretraga imaju svoje stranice: Pozivanje funkcija, Strukturirani izlazi, Napor pri zaključivanju, Ugrađena web pretraga.

Zahtev sa opcijama

Ovaj zahtev postavlja system poruku, polja uzorkovanja i napor pri zaključivanju. Koristi hostovani open-weight model, koji primenjuje sve to.

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

Odgovor ima isti oblik kao gore. Njegov usage na hostovanim open-weight modelima dodaje dva detalja: tokene prompta pročitane iz keša i tokene potrošene na rezonovanje.

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

Dužina izlaza

max_tokens radi dve stvari. Prvo, to je broj tokena koji se izdvaja sa vašeg stanja kada zahtev počne. Kada je odgovor završen, taj iznos se zamenjuje tokenima koje je zahtev iskoristio. Ako je max_tokens veći od onoga što je preostalo na vašem stanju, zahtev vraća 429 Quota exceeded čak i kada bi se sam odgovor uklopio. Pošaljite manji max_tokens da izdvojite manje.

shannon-coder-1 se na ovom endpointu računa drugačije: svaki zahtev je jedan od Shannon Coder poziva vašeg plana i za njega se ne izdvajaju tokeni. Ograničenja i stanje

Drugo, ograničava dužinu odgovora na ovim modelima:

Bez max_tokens ili max_completion_tokens vrednost je 4,096. Na shannon-coder-1 je 65,536.

Poruke

Svaka poruka je objekat sa role i content. content je string, ili niz delova kada poruka nosi više od teksta.

Sa id-jem iz porodice Shannon 3 stavite uputstva koja moraju da važe u user poruku.

Na Shannon nivoima zahtev bez korisničkog teksta i bez tools vraća 400 No user message provided.

Delovi sadržaja

Veličine, ograničenja i kompletna lista oblika imaju svoju stranicu. Slike i fajlovi

Objekat odgovora

Razlozi završetka

Odgovor bez streama prijavljuje stop ili tool_calls.

Upotreba

Na hostovanim open-weight modelima prompt_tokens su vaše poruke i definicije alata izbrojane sopstvenim tokenizerom modela, plus tokeni svih slika. Endpointi za brojanje tokena vraćaju isti broj pre nego što pošaljete. Brojanje tokena

Na Shannon nivoima prompt_tokens broji sve što je model pročitao da napiše odgovor, pa je veći od samog teksta vaših poruka.

Streaming

Kada je stream postavljen na true, odgovor stiže kao chat.completion.chunk događaji i završava se sa data: [DONE]. Poslednji deo pre toga nosi finish_reason i usage; stream_options nisu potrebni. Oblici delova, keep-alive linije i greške unutar streama imaju svoju stranicu. Streaming

Greške

Greška je JSON objekat sa članom error. Provere idu ovim redom: API ključ, telo zahteva, id modela, pa stanje. Tabela navodi šta ovaj endpoint najčešće vraća. Kompletna lista, sa uputstvom šta ponoviti, ima svoju stranicu. Upravljanje greškama

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