cicora.ai
Spesifikasi APIPenjanaan teks

Chat Completions

Cipta perbualan berbilang giliran dalam format messages yang lazim dan pilih model bagi setiap permintaan.

Rujukan penyepaduan: pilih parameter dan keupayaan yang tersedia daripada tetapan API akaun serta katalog model untuk persekitaran anda.

Mesej dan peranan

Tatasusunan messages membawa konteks sebagai jujukan tersusun. System menetapkan peraturan tugasan, user menambah permintaan, manakala assistant dan tool mengekalkan sejarah pelaksanaan.

Jangan bina sejarah dengan menggabungkan rentetan: kekalkan peranan dan susunan asal setiap mesej.

Pelengkapan sembang
bash
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": "system", "content": "Be concise and cite assumptions."},
      {"role": "user", "content": "Draft a release checklist."}
    ],
    "temperature": 0.2
  }'

Kawal output

  • model mengenal pasti keluarga dan varian model.
  • temperature, top_p dan had output mengawal variasi serta saiz respons.
  • Hantar hanya parameter yang disenaraikan sebagai disokong untuk model yang dipilih.

Gelung yang boleh dipercayai

Asingkan kegagalan pengangkutan daripada respons model dengan finish_reason. Penolakan atau sempadan konteks ialah data antara muka, bukan alasan untuk menggantikan hasil.

Apabila peraturan pengekalan data anda membenarkannya, simpan badan permintaan sumber dan respons ternormal tanpa kelayakan akses.