Seedance 2.5 đã ra mắt | Dùng thử trong trình tạo video →

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/cli

Ba lệnh và bạn đã sẵn sàng triển khai

1

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
2

Đă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 login
3

Chạ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.

~/projects/marketing
# 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 install

Hoạ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.

WaveSpeed CLI — Mọi mô hình AI từ terminal và agent của bạn