cicora.ai
Špecifikácia APIFormát Messages

Messages API

Pre konverzácie používajte formát Messages so systémovým pokynom na najvyššej úrovni a výslovným limitom výstupu.

Referenčná dokumentácia integrácie: parametre a dostupné funkcie vyberte z nastavení API účtu a katalógu modelov pre svoje prostredie.

Zostavte správu

Požiadavka obsahuje model, messages a max_tokens; systémový pokyn sa posiela v samostatnom poli system. Zachovajte roly a poradie správ, aby opakovanie mohlo reprodukovať kontext.

Priame volanie HTTP používa https://cicora.ai/api/v1/messages, zatiaľ čo Messages SDK dostane iba koreň brány https://cicora.ai/api a sám pripojí /v1/messages.

Požiadavka Messages API
bash
curl --request POST https://cicora.ai/api/v1/messages \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 500,
    "system": "Answer with a compact checklist.",
    "messages": [{"role": "user", "content": "Prepare a release plan."}]
  }'

Nástroje a streamovanie

  • tools a tool_choice pridávajte iba pre modely, ktoré ich podporujú.
  • Režim streamovania spracujte ako postupnosť udalostí, nie ako jeden objekt JSON.
  • Pred vykonaním úkonu potvrďte tvar argumentov nástroja.

Vyberte formát

V jednej požiadavke nemiešajte polia z dvoch formátov. Na hranici klienta vyberte chat alebo messages a internú históriu normalizujte raz.

Migráciu otestujte pomocou uloženej odidentifikovanej konverzácie vrátane výsledku nástroja a dlhého kontextu.