Susun mesej
Permintaan mengandungi model, messages dan max_tokens; arahan sistem dihantar dalam medan system yang berasingan. Kekalkan peranan dan susunan mesej supaya percubaan semula boleh menghasilkan semula konteks.
Panggilan HTTP mentah menggunakan https://cicora.ai/api/v1/messages, manakala SDK Messages hanya menerima akar gerbang https://cicora.ai/api dan menambah /v1/messages sendiri.
Permintaan 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."}]
}'Alat dan penstriman
- Tambah tools dan tool_choice hanya untuk model yang menyokongnya.
- Kendalikan mod penstriman sebagai jujukan peristiwa dan bukannya satu objek JSON.
- Sahkan bentuk argumen alat sebelum melaksanakan tindakan.
Pilih format
Jangan campurkan medan daripada dua format dalam satu permintaan. Pilih chat atau messages pada sempadan klien dan normalkan sejarah dalaman sekali sahaja.
Uji migrasi dengan perbualan tersimpan yang dinyahkenal pasti, termasuk hasil alat dan konteks panjang.