cicora.ai
API-specifikationMessages-format

Messages API

Använd Messages-formatet för konversationer med en systeminstruktion på toppnivå och en uttrycklig utdatagräns.

Integrationsreferens: välj parametrar och tillgängliga funktioner från API-inställningarna för ditt konto och modellkatalogen för din miljö.

Sätt samman ett meddelande

En begäran innehåller model, messages och max_tokens; systeminstruktionen skickas i ett separat system-fält. Bevara roller och meddelandeordning så att ett nytt försök kan återskapa kontexten.

Råa HTTP-anrop använder https://cicora.ai/api/v1/messages, medan ett Messages SDK endast tar emot gateway-roten https://cicora.ai/api och själv lägger till /v1/messages.

Begäran till 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."}]
  }'

Verktyg och strömning

  • Lägg endast till tools och tool_choice för modeller som stöder dem.
  • Hantera strömningsläget som en följd av händelser i stället för ett JSON-objekt.
  • Bekräfta formen på verktygsargumenten innan en åtgärd utförs.

Välj ett format

Blanda inte fält från två format i en begäran. Välj chat eller messages vid klientgränsen och normalisera den interna historiken en gång.

Testa migreringen med en sparad avidentifierad konversation, inklusive ett verktygsresultat och lång kontext.