cicora.ai
API specifikacijaMessages formatas

Messages API

Pokalbiams naudokite Messages formatą su aukščiausio lygio sistemos instrukcija ir aiškia išvesties riba.

Integracijų žinynas: savo paskyros API nustatymuose ir jūsų aplinkos modelių kataloge pasirinkite parametrus bei galimas funkcijas.

Sudarykite pranešimą

Užklausoje yra model, messages ir max_tokens; sistemos nurodymas siunčiamas atskirame lauke system. Išsaugokite vaidmenis ir pranešimų tvarką, kad pakartotinis bandymas galėtų atkurti kontekstą.

Tiesioginės HTTP užklausos kreipiasi į https://cicora.ai/api/v1/messages, o Messages SDK gauna tik šliuzo šaknį https://cicora.ai/api ir pats prideda /v1/messages.

Messages API užklausa
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."}]
  }'

Įrankiai ir srautinis perdavimas

  • tools ir tool_choice pridėkite tik juos palaikantiems modeliams.
  • Srautinį režimą apdorokite kaip įvykių seką, o ne vieną JSON objektą.
  • Prieš atlikdami veiksmą patvirtinkite įrankio argumentų formą.

Pasirinkite formatą

Vienoje užklausoje nemaišykite dviejų formatų laukų. Kliento riboje pasirinkite chat arba messages, o vidinę istoriją normalizuokite vieną kartą.

Perkėlimą išbandykite su išsaugotu nuasmenintu pokalbiu, įskaitant įrankio rezultatą ir ilgą kontekstą.