cicora.ai
Specifikacija API-jaOblika Messages

Messages API

Za pogovore uporabite obliko Messages z navodilom sistema na najvišji ravni in izrecno omejitvijo izhoda.

Referenčna dokumentacija za integracijo: parametre in razpoložljive zmožnosti izberite v nastavitvah API-ja svojega računa in v katalogu modelov za svoje okolje.

Sestavite sporočilo

Zahteva vsebuje model, messages in max_tokens; sistemsko navodilo se pošlje v ločenem polju system. Ohranite vloge in vrstni red sporočil, da lahko ponovni poskus poustvari kontekst.

Neposredni klici HTTP uporabljajo https://cicora.ai/api/v1/messages, medtem ko SDK Messages prejme le koren prehoda https://cicora.ai/api in sam doda /v1/messages.

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

Orodja in pretakanje

  • tools in tool_choice dodajte le pri modelih, ki ju podpirajo.
  • Pretočni način obravnavajte kot zaporedje dogodkov, ne kot en predmet JSON.
  • Pred izvedbo dejanja potrdite obliko argumentov orodja.

Izberite obliko

V eni zahtevi ne mešajte polj iz dveh oblik. Na meji odjemalca izberite chat ali messages, interno zgodovino pa normalizirajte enkrat.

Selitev preizkusite s shranjenim deidentificiranim pogovorom, ki vključuje rezultat orodja in dolg kontekst.