OpenAI ra mắt CLI chính thức cho API REST: công cụ dòng lệnh dành cho lập trình viên

OpenAI vừa chính thức công bố openai-cli, một công cụ dòng lệnh (CLI) dành riêng cho API REST của hãng. Đây là bước tiến đáng chú ý khi trước đó, các lập trình viên thường phải tự viết script hoặc dùng thư viện SDK để tương tác với API. Giờ đây, mọi thao tác có thể được thực hiện trực tiếp từ terminal.

Cài đặt linh hoạt trên nhiều nền tảng

Công cụ hỗ trợ hai phương thức cài đặt chính:

• Homebrew dành cho người dùng macOS và Linux với lệnh brew install openai/tools/openai
• Go dành cho lập trình viên muốn cài từ mã nguồn, yêu cầu Go phiên bản 1.26 trở lên

Sau khi cài qua Go, người dùng cần thêm thư mục bin của Go vào biến môi trường PATH để có thể gọi lệnh openai từ bất kỳ đâu.

Cấu trúc lệnh theo tài nguyên

CLI được thiết kế theo mô hình dựa trên tài nguyên, với cú pháp tổng quát:

openai [tài nguyên] [tài nguyên con...] [cờ...]

Các endpoint API tiêu chuẩn yêu cầu khóa API thông thường (OPENAI_API_KEY), trong khi các endpoint quản trị cần khóa admin riêng (OPENAI_ADMIN_KEY). Ví dụ, để gửi một yêu cầu đơn giản:

openai responses create --input "Say this is a test" --model gpt-5.5

Tính năng nổi bật

Công cụ mang đến nhiều tiện ích cho lập trình viên:

• Tự động gợi ý cập nhật: CLI kiểm tra phiên bản mới qua metadata GitHub công khai, tối đa một lần mỗi ngày và hoàn toàn không tự động cài đặt
• Định dạng đầu ra đa dạng: hỗ trợ json, jsonl, yaml, raw, pretty và chế độ văn bản dễ đọc mặc định
• Xử lý tệp tiện lợi: tải lên, tải xuống và xem metadata tệp trực tiếp qua lệnh files
• Tạo ảnh từ terminal: lệnh images generate lưu ảnh vào thư mục ~/Downloads/gpt-images/ và in đường dẫn
• Biến đổi dữ liệu với GJSON: cho phép trích xuất dữ liệu phức tạp từ phản hồi API

Bảo mật được đặt lên hàng đầu

Một điểm đáng chú ý là CLI hỗ trợ Mutual TLS (mTLS) ở giai đoạn beta, cho phép xác thực bằng chứng chỉ khách và khóa riêng tách biệt. Công cụ cũng tự động ẩn các giá trị header nhạy cảm trong log debug và hỗ trợ biến môi trường OPENAI_CUSTOM_HEADERS để tránh lộ thông tin xác thực trong lịch sử shell.

Ngoài ra, cơ chế xử lý stdin an toàn (qua biến OPENAI_UNTRUSTED_STDIN) giúp ngăn chặn việc đọc tệp ngoài ý muốn khi nhận dữ liệu từ nguồn không tin cậy — một biện pháp phòng vệ quan trọng trước các kịch bản tấn công chèn lệnh.

Điều kiện sử dụng và giấy phép

Dự án được phát hành theo giấy phép Apache 2.0, cho phép sử dụng rộng rãi. Tuy nhiên, OpenAI giới hạn pull request chỉ dành cho cộng tác viên của repository, trong khi báo lỗi và đề xuất tính năng vẫn được chào đón qua GitHub Issues.

Với các lập trình viên Việt Nam đang xây dựng ứng dụng tích hợp AI, openai-cli hứa hẹn là công cụ hữu ích giúp tự động hóa quy trình thử nghiệm API, tích hợp vào pipeline CI/CD và quản lý tài nguyên AI ngay trong môi trường terminal quen thuộc — giảm bớt nhu cầu viết mã boilerplate chỉ để kiểm tra một endpoint.