cicora.ai
API-specifikationMessages-format

Messages API

Brug Messages-formatet til samtaler med en systeminstruktion på øverste niveau og en udtrykkelig grænse for output.

Integrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.

Sammensæt en meddelelse

En anmodning indeholder model, messages og max_tokens; systeminstruktionen sendes i et separat system-felt. Bevar roller og meddelelsesrækkefølge, så et nyt forsøg kan genskabe konteksten.

Rå HTTP-kald bruger https://cicora.ai/api/v1/messages, mens et Messages-SDK kun modtager gateway-roden https://cicora.ai/api og selv tilføjer /v1/messages.

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

Værktøjer og streaming

  • Tilføj tools og tool_choice kun for modeller, der understøtter dem.
  • Behandl strømmemodus som en hændelsessekvens i stedet for ét JSON-objekt.
  • Bekræft værktøjsargumenternes form, før en handling udføres.

Vælg et format

Bland ikke felter fra to formater i én anmodning. Vælg chat eller Messages ved klientgrænsen, og normaliser den interne historik én gang.

Test migreringen med en gemt, afidentificeret samtale som inkluderer et værktøjsresultat og lang kontekst.