WaveSpeed CLI
Mọi mô hình WaveSpeed — ngay từ terminal và agent của bạn
Một CLI mã nguồn mở để chạy bất kỳ mô hình AI nào của WaveSpeed. Ảnh, video, âm thanh, 3D. Được xây dựng cho terminal và các coding agent như Codex, Claude Code, Claude Cowork và Cursor.
$npm install -g @wavespeed/cliBa lệnh và bạn đã sẵn sàng triển khai
Cài đặt
Yêu cầu Node 18+. Một lần cài đặt toàn cục mang lại cho bạn binary wavespeed ở mọi nơi.
$npm install -g @wavespeed/cliĐăng nhập
Mở trang access key trong trình duyệt của bạn. Chúng tôi tự động phát hiện key đã sao chép và xác thực nó trực tiếp.
$wavespeed loginChạy bất kỳ mô hình nào
Cùng một cấu trúc cho mọi mô hình. Truyền vào model ID và dữ liệu đầu vào — nhận lại một URL CDN, hoặc dùng --json để đưa vào script của bạn.
$wavespeed run wavespeed-ai/z-image/turbo -p "a cat"Được xây dựng cho con người và agent
Trợ giúp động cho từng mô hình
Chạy wavespeed run <model> -h và CLI sẽ tải trực tiếp schema đầu vào của mô hình đó và in ra chính xác các cờ mà nó chấp nhận — không cần đoán.
Alias đi kèm với repo của bạn
Định nghĩa các lối tắt có tên trong wavespeed.json để gói gọn một mô hình + dữ liệu đầu vào mặc định. Cả nhóm kéo tệp về, gõ wavespeed run hero, nhận kết quả đúng thương hiệu.
Thiết kế thân thiện với agent
Mọi lệnh đều hỗ trợ --json trên stdout và tiến trình trên stderr. Thả một tệp SKILL.md để Codex, Claude Code, Claude Cowork và Cursor biết cách gọi nó.
Không phép thuật, không daemon
CLI không bao giờ thay đổi prompt của bạn và không bao giờ mở tiến trình chạy nền. Nó gọi trực tiếp api.wavespeed.ai. Mã nguồn mở, giấy phép MIT.
Một phiên làm việc thực tế trông như thế nào
Từ duyệt danh mục đến kết quả JSON — ba lệnh.
# 1. browse the catalog
$ wavespeed models --type text-to-image --popular
# 2. inspect a model's inputs — schema fetched live
$ wavespeed run wavespeed-ai/z-image/turbo -h
* prompt string
size string default: "1024*1024"
strength number default: 0.6 range: 0..1
output_format string default: "jpeg" enum: jpeg | png | webp
# 3. run — JSON out so you can pipe it
$ wavespeed run wavespeed-ai/z-image/turbo \
-p "a cyberpunk skyline at golden hour" --json
{
"model": "wavespeed-ai/z-image/turbo",
"outputs": ["https://cdn.wavespeed.ai/outputs/skyline.jpeg"],
"elapsed_ms": 4718
}Kết nối với coding agent của bạn chỉ trong một bước
Không cần MCP server, không cần cấu hình thêm. Các coding agent như Codex, Claude Code và Claude Cowork đã biết cách chạy lệnh shell — tệp SKILL.md cho chúng biết cách dùng CLI.
$wavespeed skill installHoạt động với Codex, Claude Code, Claude Cowork, Cursor và bất kỳ agent nào tự động tải .claude/skills/*.
Mã nguồn mở. Sẵn sàng ngay hôm nay.
Giấy phép MIT, thuộc phạm vi @wavespeed trên npm, được lưu trữ trên GitHub. Chào đón các issue và PR.