Sestavení zprávy
Požadavek obsahuje model, messages a max_tokens; systémový pokyn se posílá v samostatném poli system. Zachovejte role a pořadí zpráv, aby opakování dokázalo reprodukovat kontext.
Přímá volání HTTP používají https://cicora.ai/api/v1/messages, zatímco SDK Messages dostane pouze kořen brány https://cicora.ai/api a samo připojí /v1/messages.
Požadavek 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."}]
}'Nástroje a streamování
- Nástroje a tool_choice přidávejte pouze u modelů, které je podporují.
- Režim streamování zpracovávejte jako posloupnost událostí, nikoli jako jeden objekt JSON.
- Před provedením akce ověřte strukturu argumentů nástroje.
Výběr formátu
Nekombinujte v jednom požadavku pole ze dvou formátů. Na hranici klienta zvolte chat nebo messages a interní historii normalizujte pouze jednou.
Migraci otestujte s uloženou deidentifikovanou konverzací včetně výsledku nástroje a dlouhého kontextu.