cicora.ai
API-spesifikasjonMessages-format

Messages API

Bruk Messages-formatet for samtaler med en systeminstruksjon på toppnivå og en uttrykkelig grense for utdata.

Integrasjonsreferanse: Velg parametere og tilgjengelige funksjoner fra API-innstillingene for kontoen og modellkatalogen for miljøet ditt.

Sett sammen en melding

En forespørsel inneholder model, messages og max_tokens; systeminstruksjonen sendes i et eget systemfelt. Behold rollene og meldingsrekkefølgen slik at et nytt forsøk kan gjenskape konteksten.

Rå HTTP-kall bruker https://cicora.ai/api/v1/messages, mens en Messages SDK bare mottar gateway-roten https://cicora.ai/api og selv legger til /v1/messages.

Forespørsel til 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."}]
  }'

Verktøy og strømming

  • Legg til tools og tool_choice bare for modeller som støtter dem.
  • Behandle strømmemodus som en hendelsessekvens i stedet for ett JSON-objekt.
  • Bekreft formen på verktøyargumentene før en handling utføres.

Velg et format

Ikke bland felt fra to formater i én forespørsel. Velg chat eller messages ved klientgrensen, og normaliser den interne historikken én gang.

Test migreringen med en lagret, avidentifisert samtale som inkluderer et verktøyresultat og lang kontekst.