cicora.ai
Đặc tả APICLI và ứng dụng

CLI và tích hợp

Cấu hình ứng dụng khách bằng khóa, mô hình và URL cơ sở khớp với giao thức; giữ bí mật trong môi trường.

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.

Chọn URL tương thích

Với ứng dụng khách kiểu OpenAI, đặt CICORA_API_BASE_URL=https://cicora.ai/api/v1 và không thêm /v1 lần thứ hai.

Với ứng dụng khách Messages hoặc Claude Code, đặt ANTHROPIC_BASE_URL=https://cicora.ai/api: ứng dụng khách đó tự nối /v1/messages. Xác minh cấu hình qua danh mục mô hình trước khi gửi yêu cầu suy luận.

Cấu hình ứng dụng khách tương thích
bash
export CICORA_API_BASE_URL=https://cicora.ai/api/v1
export CICORA_API_KEY=replace_with_your_key

curl "$CICORA_API_BASE_URL/models" \
  --header "Authorization: Bearer $CICORA_API_KEY"

Khởi chạy an toàn

  • Truyền biến môi trường qua trình quản lý bí mật hoặc hồ sơ an toàn.
  • Loại trừ tệp .env và cấu hình đã xuất khỏi commit.
  • Cấp cho mỗi ứng dụng một khóa riêng để có thể thu hồi quyền truy cập mà không dừng các ứng dụng khác.

Hợp đồng khả chuyển

Lưu nhật ký yêu cầu và phản hồi không chứa Authorization hoặc dữ liệu người dùng khi chế độ lưu giữ của bạn cho phép.

Nếu ứng dụng khách tự ghép đường dẫn, hãy so sánh URL cuối cùng trong nhật ký gỡ lỗi trước lần tạo đầu tiên.