Utwórz wiadomość
Żądanie zawiera model, messages i max_tokens; instrukcja systemowa jest wysyłana w osobnym polu system. Zachowaj role i kolejność wiadomości, aby ponowienie mogło odtworzyć kontekst.
Surowe wywołanie HTTP korzysta z https://cicora.ai/api/v1/messages, natomiast pakiet SDK Messages otrzymuje tylko główny adres bramy https://cicora.ai/api i sam dodaje /v1/messages.
Żądanie API Messages
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."}]
}'Narzędzia i strumieniowanie
- Dodawaj tools i tool_choice tylko w przypadku modeli, które je obsługują.
- Obsługuj tryb strumieniowania jako sekwencję zdarzeń, a nie jeden obiekt JSON.
- Przed wykonaniem działania potwierdź strukturę argumentów narzędzia.
Wybierz format
Nie mieszaj pól z dwóch formatów w jednym żądaniu. Wybierz chat lub messages na granicy klienta i jednokrotnie znormalizuj historię wewnętrzną.
Przetestuj migrację na zapisanej rozmowie pozbawionej cech identyfikujących, zawierającej wynik narzędzia i długi kontekst.