WaveSpeed CLI · MCP

Tạo ảnh và video từ Claude Code, Codex và terminal 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.

CLI

@wavespeed/cli

Cài một lần, chạy mọi model từ shell hoặc script.

$npm install -g @wavespeed/cli

MCP

@wavespeed/mcp

Máy chủ MCP được lưu trữ: thêm bằng địa chỉ trong mọi client MCP rồi đăng nhập.

https://api.wavespeed.ai/mcp

Thiết lập WaveSpeed trong agent của bạn

Chọn công cụ của bạn để có cách thiết lập nhanh nhất. Mọi lựa chọn đều có toàn bộ danh mục model, kèm giá trước khi chi tiêu.

Claude Code

Plugin

Thêm máy chủ MCP được lưu trữ và skill WaveSpeed trong một lần cài.

  1. 1

    Thêm marketplace WaveSpeed

    $claude plugin marketplace add WaveSpeedAI/claude-plugins
  2. 2

    Cài plugin

    $claude plugin install wavespeed@wavespeed
  3. 3

    Trong Claude Code, chạy /mcp, chọn wavespeed và chấp thuận kết nối trên trình duyệt

    /mcp
Sau đó hãy hỏi: “Tạo ảnh hero 16:9 về đường chân trời cyberpunk và báo giá cho tôi trước.”

Cách khác

Chỉ máy chủ MCP, không kèm skill:

$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp

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

  1. 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. 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. 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"
  • Dạy agent lập trình dùng CLI

    Cài một skill để Codex, Claude Code, Cursor và các agent khác biết cách gọi CLI.

    $wavespeed skill install
  • Không có Node.js?

    Trên macOS và Linux, bạn có thể cài tệp thực thi độc lập. Trên Windows, hãy tải về từ GitHub Releases.

    $curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash
  • Luôn cập nhật

    Nâng cấp lên phiên bản mới nhất chỉ với một lệnh.

    $wavespeed upgrade
  • Dùng mô hình WaveSpeed trong tác nhân lập trình của bạn

    Cấu hình Claude Code, Codex, OpenCode và các công cụ khác để dùng API LLM của WaveSpeed. Có thể hoàn tác bất cứ lúc nào.

    $wavespeed setup

Đượ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://example.com/output/skyline.jpeg"],
  "elapsed_ms": 4718
}

Tạo ảnh và video từ Claude Code và Codex

Cài CLI và skill đi kèm một lần, sau đó chỉ cần nhắn. Agent lập trình sẽ chạy lệnh và lưu file vào dự án của bạn.

Claude Code · WaveSpeed CLI

Làm giúp mình ảnh hero 16:9 cho landing page quán cà phê: ấm cúng, lúc bình minh, chừa chỗ cho tiêu đề.

Một quán cà phê ấm cúng lúc bình minh nhìn từ ngoài phố

Ảnh hero của bạn đây: ánh bình minh ấm áp chiếu lên mặt tiền quán, khung hình rộng để làm banner. · Chi phí $0.045

generate image
$ wavespeed generate image "cozy coffee shop at sunrise, warm light in the windows, room for a headline" --aspect-ratio 16:9 --download

Đẹp đó. Viết "Open at 7" lên cửa kính phía trước nhé.

Cùng quán cà phê đó với dòng chữ "Open at 7" trên cửa kính

Xong rồi: "Open at 7" được viết tay trên cửa kính, mọi thứ khác giữ nguyên. · Chi phí $0.045

edit image
$ wavespeed edit image "add the words \"Open at 7\" in white hand lettering on the front window" --image @./hero.jpg --download

Tạo ảnh và video từ agent lập trình của bạn

Làm sao để tạo ảnh từ Claude Code?

Cài CLI bằng npm install -g @wavespeed/cli, đăng nhập bằng wavespeed login và thêm skill bằng wavespeed skill install. Sau đó nhờ Claude Code tạo ảnh; nó sẽ chạy wavespeed generate image và lưu file vào dự án của bạn.

Làm sao để tạo ảnh và video từ Codex?

Cài và đăng nhập CLI, rồi chạy wavespeed skill install để Codex biết các lệnh. Nhờ Codex tạo ảnh hoặc video, nó sẽ chạy giúp bạn; hoặc cài plugin WaveSpeed từ /plugins.

Agent thực sự chạy những gì?

Những lệnh bình thường mà bạn có thể đọc và tự chạy lại: wavespeed generate image, wavespeed edit image, wavespeed generate video. File cục bộ được truyền bằng @./file và kết quả được tải về bằng --download.

Có dùng được trong Cursor và các agent lập trình khác không?

Có. Bất kỳ agent nào chạy được lệnh terminal đều dùng được CLI, và skill sẽ dạy nó các lệnh. Agent hỗ trợ MCP cũng có thể kết nối tới máy chủ được lưu trữ sẵn.

Tôi có tạo được video không?

Có. wavespeed generate video tạo clip từ văn bản, ảnh khởi đầu hoặc ảnh tham chiếu, còn wavespeed edit video và extend video chỉnh sửa hoặc kéo dài một video có sẵn.

Chi phí thế nào?

Bạn trả theo mỗi lần tạo từ số dư WaveSpeed, không cần đăng ký gói. Thêm --estimate để xem giá trước khi chạy; mỗi kết quả đều cho biết chi phí.

Agent của bạn làm được gì qua MCP

Công cụ tắt cho việc ảnh và video hằng ngày, cùng toàn bộ danh mục: tìm model, đọc đầu vào thật của model, xem giá rồi chạy.

generate_image

Tạo ảnh từ prompt, có thể kèm ảnh tham chiếu

edit_image

Chỉnh sửa, đổi phong cách hoặc ghép ảnh có sẵn

generate_video

Tạo video từ prompt, khung hình đầu hoặc tham chiếu

edit_video

Thay đổi diễn biến trong video có sẵn

extend_video

Nối dài video bằng cảnh quay mới

list_models

Tìm trong danh mục trực tiếp theo văn bản hoặc loại

get_model_schema

Đầu vào thật, trường bắt buộc và giá trị mặc định của model

run_model

Chạy mọi model; đầu vào @tệp cục bộ được tải lên tự động

get_price

Báo giá trước khi chi tiêu

get_balance

Xem số dư tín dụng

upload_file

Biến tệp cục bộ thành URL được lưu trữ

get_prediction

Lấy lại một lần tạo dài theo id

list_predictions

Xem lịch sử các lần tạo của bạn

list_billings

Xem từng khoản trừ tiền và hoàn tiền

get_usage

Theo dõi chi tiêu và mức dùng theo ngày và mô hình

delete_predictions

Xóa lượt chạy khỏi lịch sử (hỏi trước)

upload_file chỉ có ở máy chủ cục bộ. Máy chủ từ xa không đọc được tệp của bạn: hãy dùng URL công khai, dùng create_upload trong công cụ có thể gửi yêu cầu HTTP, hoặc trong ChatGPT hãy đính kèm tệp vào cuộc trò chuyện.

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.

Thích ứng dụng đồ họa hơn? Hãy thử WaveSpeed DesktopXem mọi cách kết nối WaveSpeed