Flatkey CLI mang khả năng tạo nội dung đa phương tiện vào terminal của bạn với một số dư duy nhất. Mọi lệnh đều chấp nhận --json, giúp gọi an toàn từ script, CI job hoặc AI agent phân tích stdout.
Cài đặt và xác thực
Yêu cầu Node.js 18 trở lên. Với CI, hãy đặt biến môi trường thay vì đăng nhập:
Kiểm tra những gì CLI đang sử dụng:
Tạo file đầu tiên của bạn
Luôn truyền --model. Model hình ảnh mặc định tích hợp hiện không thể định tuyến và trả về No available channel.
Các lệnh
Tùy chọn toàn cục
Đặt -o trước --json. Dạng rút gọn bị từ chối là đối số không mong muốn khi xuất hiện sau --json. --output hoạt động ở bất kỳ vị trí nào.
Tùy chọn video
--ratio chấp nhận 16:9, 9:16, 4:3, 3:4, 21:9 và 1:1. --resolution chấp nhận 480p, 720p và 1080p, nhưng mỗi model chỉ hỗ trợ một phần trong dải đó — xem Tạo video.
Tùy chọn âm thanh
Chạy flatkey audio voices --json và truyền voice_id được liệt kê vào --voice-id.
Điều khiển từ agent
Ở chế độ --json, stdout chứa đúng một đối tượng JSON và stderr chứa lỗi JSON. Chạy flatkey help --ai để in mô tả giao thức ngắn gọn mà agent có thể đọc lúc chạy.
Liệt kê các model trước, rồi mới tạo. Model id được mã hóa cứng là nguyên nhân phổ biến nhất gây ra lỗi khi chạy.
Khôi phục
Chỉ thử lại sau khi đã thay đổi request. Các lỗi này mang tính xác định, vì vậy lặp lại các đối số giống hệt sẽ tốn thời gian mà không thay đổi kết quả.