cicora.ai
Đặc tả APITạo văn bản

Chat Completions

Tạo hội thoại nhiều lượt theo định dạng messages quen thuộc và chọn mô hình cho từng yêu cầu.

Tài liệu tham khảo tích hợp: chọn tham số và năng lực khả dụng từ cài đặt API tài khoản và danh mục mô hình cho môi trường của bạn.

Tin nhắn và vai trò

Mảng messages mang ngữ cảnh theo thứ tự. Vai trò system đặt quy tắc tác vụ, user thêm yêu cầu, còn assistant và tool lưu lịch sử thực thi.

Không tạo lịch sử bằng cách nối chuỗi: hãy giữ vai trò và thứ tự ban đầu của mọi tin nhắn.

Tạo phản hồi trò chuyện
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
  }'

Kiểm soát đầu ra

  • model xác định họ và biến thể mô hình.
  • temperature, top_p và giới hạn đầu ra kiểm soát độ biến thiên và kích thước phản hồi.
  • Chỉ gửi các tham số được liệt kê là được hỗ trợ cho mô hình đã chọn.

Vòng lặp đáng tin cậy

Tách lỗi truyền tải khỏi phản hồi mô hình có finish_reason. Việc từ chối hoặc ranh giới ngữ cảnh là dữ liệu giao diện, không phải lý do để thay thế kết quả.

Khi quy tắc lưu giữ dữ liệu cho phép, hãy lưu nội dung yêu cầu nguồn và phản hồi đã chuẩn hóa mà không có thông tin xác thực.