Susun pesan
Permintaan memuat model, messages, dan max_tokens; instruksi sistem dikirim dalam kolom system terpisah. Pertahankan peran dan urutan pesan agar percobaan ulang dapat mereproduksi konteks.
Panggilan HTTP mentah menggunakan https://cicora.ai/api/v1/messages, sedangkan Messages SDK hanya menerima root gateway https://cicora.ai/api dan menambahkan /v1/messages sendiri.
Permintaan 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."}]
}'Alat dan streaming
- Tambahkan tools dan tool_choice hanya untuk model yang mendukungnya.
- Tangani mode streaming sebagai urutan peristiwa, bukan satu objek JSON.
- Konfirmasikan bentuk argumen alat sebelum menjalankan tindakan.
Pilih format
Jangan campurkan kolom dari dua format dalam satu permintaan. Pilih chat atau messages pada batas klien, lalu normalkan riwayat internal satu kali.
Uji migrasi menggunakan percakapan tersimpan yang telah dihilangkan identitasnya, termasuk hasil alat dan konteks panjang.