1. Chuẩn bị môi trường
Chỉ giữ khóa trong biến môi trường hoặc kho bí mật. Mã trình duyệt không được chứa khóa hoặc ghi khóa vào nhật ký.
URL cơ sở tích hợp là https://cicora.ai/api/v1. Mỗi ví dụ bên dưới nối tuyến tương ứng vào URL cơ sở này.
Yêu cầu đầu tiên
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. Soạn yêu cầu
- Dùng chính xác mã định danh mô hình do danh mục trả về.
- Gửi tin nhắn theo thứ tự hội thoại: system, user, assistant và tool khi cần.
- Bắt đầu với độ biến thiên thấp hơn, rồi tinh chỉnh tham số cho tác vụ.
3. Xử lý phản hồi
Đọc văn bản từ mục phản hồi khả dụng đầu tiên và lưu ID yêu cầu cùng ID dấu vết của bạn.
Kiểm tra trạng thái và cấu trúc lỗi trước khi thử lại. Chỉ thử lại thao tác mà ứng dụng của bạn có thể ngăn việc thực hiện trùng lặp.