1. Siapkan lingkungan
Simpan kunci hanya dalam variabel lingkungan atau penyimpanan rahasia. Kode browser tidak boleh memuat atau menuliskannya ke log.
URL dasar integrasi adalah https://cicora.ai/api/v1. Setiap contoh di bawah menambahkan rutenya ke URL dasar tersebut.
Permintaan pertama
bash
export CICORA_API_KEY=replace_with_your_key
curl --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "openai/gpt-5.6-sol",
"messages": [{"role": "user", "content": "Explain this API in one sentence."}]
}'2. Susun permintaan
- Gunakan pengenal model yang persis seperti yang dikembalikan katalog.
- Kirim pesan sesuai urutan percakapan: system, user, assistant, dan tool bila diperlukan.
- Mulai dengan variasi lebih rendah, lalu sesuaikan parameter untuk tugas tersebut.
3. Tangani respons
Baca teks dari item respons pertama yang tersedia dan simpan ID permintaan bersama ID jejak Anda sendiri.
Periksa status dan struktur kesalahan sebelum mencoba lagi. Coba ulang hanya operasi yang pekerjaan gandanya dapat dicegah oleh aplikasi Anda.