cicora.ai
ข้อกำหนด APIรูปแบบ Messages

Messages API

ใช้รูปแบบ Messages สำหรับการสนทนา โดยมีคำสั่งระบบระดับบนสุดและขีดจำกัดเอาต์พุตที่ระบุชัดเจน

เอกสารอ้างอิงการเชื่อมต่อ: เลือกพารามิเตอร์และความสามารถที่ใช้ได้จากการตั้งค่า API ของบัญชีและแค็ตตาล็อกโมเดลสำหรับสภาพแวดล้อมของคุณ

สร้างข้อความ

คำขอประกอบด้วย model, messages และ max_tokens ส่วนคำสั่งระบบจะส่งในฟิลด์ system แยกต่างหาก เก็บบทบาทและลำดับข้อความไว้เพื่อให้การลองใหม่สร้างบริบทเดิมได้

การเรียก HTTP โดยตรงใช้ https://cicora.ai/api/v1/messages, ส่วน Messages SDK รับเพียงรากเกตเวย์ https://cicora.ai/api และเติม /v1/messages เอง

คำขอ 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."}]
  }'

เครื่องมือและการสตรีม

  • เพิ่ม tools และ tool_choice เฉพาะสำหรับโมเดลที่รองรับ
  • จัดการโหมดสตรีมเป็นลำดับเหตุการณ์ ไม่ใช่ออบเจ็กต์ JSON เดียว
  • ยืนยันรูปแบบอาร์กิวเมนต์ของเครื่องมือก่อนดำเนินการ

เลือกรูปแบบ

อย่าผสมฟิลด์จากสองรูปแบบในคำขอเดียว เลือก chat หรือ messages ที่ขอบเขตไคลเอนต์ และปรับประวัติภายในให้เป็นมาตรฐานเพียงครั้งเดียว

ทดสอบการย้ายด้วยการสนทนาที่บันทึกไว้และนำข้อมูลระบุตัวตนออกแล้ว รวมถึงผลลัพธ์เครื่องมือและบริบทยาว