PiAPI CLI Quick Start: Tạo ảnh và video AI từ terminal
PiAPI CLI là giao diện dòng lệnh chính thức của PiAPI. Công cụ này giúp bạn gọi các mô hình AI đa phương thức cho ảnh, video, âm thanh, 3D và LLM trực tiếp từ terminal.
Hướng dẫn nhanh này đi từ cài đặt, xác thực API key, chạy lệnh tạo ảnh đầu tiên, tạo task video async và xem danh sách mô hình đang có.
PiAPI CLI là gì?
Định nghĩa nhanh
PiAPI CLI là công cụ dòng lệnh Node.js để chạy các mô hình PiAPI mà không cần mở dashboard web.
AI CLI hữu ích khi quy trình tạo nội dung bắt đầu trong terminal: bạn có thể lưu lệnh, chạy lại, đổi tham số và đưa vào script hoặc AI agent.
- Tạo asset từ prompt có thể lặp lại
- Kiểm thử nhanh khi xây app hoặc prototype
- Upload file local từ thư mục dự án
- Lưu output vào thư mục cố định
- Trả JSON cho script, CI hoặc agent
Tổng quan PiAPI CLI
| Gói | piapi-cli |
|---|---|
| Lệnh | piapi |
| Runtime | Node.js 18+ |
| Trường hợp chính | Tạo AI đa phương thức trong terminal |
| Phù hợp cho | Lập trình viên, tự động hóa và AI agents |
Điều kiện cần
- Node.js 18 trở lên
- PiAPI API key
- Ứng dụng terminal
Cài đặt PiAPI CLI
Cài gói piapi-cli bằng package manager JavaScript bạn dùng.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpXác thực bằng PiAPI API key
Sau khi cài đặt, kết nối CLI với tài khoản PiAPI của bạn.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Tạo ảnh AI đầu tiên từ terminal
Sau khi xác thực, bạn có thể tạo ảnh AI từ terminal bằng piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Tạo video AI đầu tiên từ terminal
Video thường mất lâu hơn ảnh, vì vậy nên chạy model video như task async.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Upload file local và tải kết quả
PiAPI CLI có thể upload file local khi giá trị input bắt đầu bằng @, rồi tải kết quả về thư mục bạn chọn.
piapi run remove-bg image=@./photo.png --download --out-dir ./outKhám phá mô hình và kiểm tra quota
Dùng các lệnh model để xem mô hình, schema và quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaCác flag PiAPI CLI hữu ích
Các flag hữu ích khi tự động hóa:
--async | Tùy chọn cho workflow CLI |
--download | Tùy chọn cho workflow CLI |
--out-dir <path> | Tùy chọn cho workflow CLI |
--stream | Tùy chọn cho workflow CLI |
--dry-run | Tùy chọn cho workflow CLI |
--output json | JSON output for scripts and automation |
--webhook <url> | Tùy chọn cho workflow CLI |
--quiet | Tùy chọn cho workflow CLI |
--non-interactive | Tùy chọn cho workflow CLI |
Dùng PiAPI CLI với AI agents và tự động hóa
PiAPI CLI cũng dùng được trong AI agent, shell script, CI job và workflow tự động hóa.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Xử lý lỗi PiAPI CLI thường gặp
Nếu lệnh đầu tiên chưa chạy, hãy kiểm tra các lỗi phổ biến này trước khi đổi prompt hoặc model.
Không tìm thấy lệnh piapi
npx piapi-cli@latest --help
API key thiếu hoặc không hợp lệ
piapi auth status
Lệnh video trả về task ID thay vì file
piapi task get <id>
Khi nào nên dùng PiAPI CLI thay vì Web UI?
Dùng PiAPI CLI khi bạn muốn workflow có thể lặp lại, script hóa hoặc giao cho AI agent. Web UI tốt cho khám phá trực quan; CLI tốt hơn cho tự động hóa.
FAQ
PiAPI CLI là gì?
PiAPI CLI là công cụ dòng lệnh Node.js để chạy các mô hình PiAPI mà không cần mở dashboard web.
Cài PiAPI CLI như thế nào?
npm install -g piapi-cli / npx piapi-cli@latest --help
Có thể tạo ảnh và video AI từ terminal không?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Bắt đầu xây dựng với PiAPI CLI
PiAPI CLI giúp lập trình viên và AI agent tạo ảnh, video, âm thanh, 3D asset và phản hồi LLM từ dòng lệnh. Hãy bắt đầu bằng cài đặt, xác thực API key, rồi dùng piapi run để gọi model bạn cần.
