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/cliMCP
@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/mcpThiế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
PluginThêm máy chủ MCP được lưu trữ và skill WaveSpeed trong một lần cài.
- 1
Thêm marketplace WaveSpeed
$claude plugin marketplace add WaveSpeedAI/claude-plugins - 2
Cài plugin
$claude plugin install wavespeed@wavespeed - 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
Cách khác
Chỉ máy chủ MCP, không kèm skill:
$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcpCodex
PluginThêm máy chủ MCP được lưu trữ và skill WaveSpeed trong một lần cài.
- 1
Thêm marketplace WaveSpeed
$codex plugin marketplace add WaveSpeedAI/codex-plugins - 2
Trong Codex, mở /plugins, cài WaveSpeed và chấp thuận kết nối trên trình duyệt
/plugins
Cách khác
Chỉ máy chủ MCP, không kèm skill:
$codex mcp add wavespeed --url https://api.wavespeed.ai/mcp && codex mcp login wavespeedOpenCode
PluginThêm máy chủ MCP được lưu trữ và skill WaveSpeed trong một lần cài.
- 1
Thêm plugin vào opencode.json
{ "plugin": ["@wavespeed/opencode"] } - 2
Đăng nhập và chấp thuận kết nối trên trình duyệt
$opencode mcp auth wavespeed
Cách khác
Chỉ máy chủ MCP, không kèm skill:
$opencode mcp add wavespeed --url https://api.wavespeed.ai/mcp && opencode mcp auth wavespeedCursor
Một cú nhấpKết nối tới máy chủ MCP được lưu trữ. Không cần cài gì.
- 1
Nhấn nút rồi xác nhận trong Cursor
Thêm vào Cursor - 2
Đăng nhập WaveSpeed khi được hỏi và chấp thuận kết nối
Cách khác
Hoặc thêm đoạn này vào mcp.json:
{
"mcpServers": {
"wavespeed": { "url": "https://api.wavespeed.ai/mcp" }
}
}VS Code
Một lệnhKết nối tới máy chủ MCP được lưu trữ. Không cần cài gì.
- 1
Chạy lệnh này trong terminal
$code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}' - 2
Đăng nhập WaveSpeed khi được hỏi và chấp thuận kết nối
Cách khác
Chạy máy chủ trên máy của bạn:
Claude
Connector tùy chỉnhDùng được trong Claude trên web và Claude Desktop. Không cần cài gì.
- 1
Trong Claude, mở Customize → Connectors → Add custom connector
- 2
Dán địa chỉ này
https://api.wavespeed.ai/mcp - 3
Đăng nhập bằng tài khoản WaveSpeed
Cách khác
Chạy máy chủ trên máy của bạn:
ChatGPT
Connector tùy chỉnhThêm WaveSpeed vào ChatGPT như một máy chủ MCP tùy chỉnh. Không cần cài gì.
- 1
Trong ChatGPT, mở Plugins và chọn Add custom MCP server
- 2
Dán địa chỉ này, giữ /mcp ở cuối
https://api.wavespeed.ai/mcp - 3
Chọn OAuth và đăng nhập bằng tài khoản WaveSpeed
Cách khác
ChatGPT không đọc được tệp trên máy bạn: hãy đính kèm vào cuộc trò chuyện hoặc dùng URL công khai.
Gemini CLI
Tiện ích mở rộngGói skill WaveSpeed cho Gemini CLI, cài và cập nhật bằng một lệnh.
- 1
Cài WaveSpeed CLI và đăng nhập
$npm install -g @wavespeed/cli && wavespeed login - 2
Cài tiện ích mở rộng
$gemini extensions install https://github.com/WaveSpeedAI/wavespeed-gemini-extension
DeepSeek Harness
Plugin skillPlugin dsh tự động đăng ký skill WaveSpeed.
- 1
Cài WaveSpeed CLI và đăng nhập
$npm install -g @wavespeed/cli && wavespeed login - 2
Thêm plugin skill
$dsh plugin --profile web add github:WaveSpeedAI/wavespeed-dsh-skill
Client MCP khác
MCP được lưu trữWindsurf, Cline, GitHub Copilot, Goose và mọi client MCP khác: thêm máy chủ được lưu trữ bằng địa chỉ của nó.
- 1
Thêm máy chủ MCP từ xa với địa chỉ này. Hầu hết client sẽ cho bạn đăng nhập qua trình duyệt.
https://api.wavespeed.ai/mcp
Cách khác
Client không hỗ trợ MCP từ xa? Chạy máy chủ cục bộ:
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp@latest"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}Đã đăng nhập bằng wavespeed login? Máy chủ cục bộ dùng phiên đó, nên có thể bỏ dòng env.
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"
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 installKhô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 | bashLuô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 upgradeDù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.
# 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.
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 đề.
/filters:quality(82)/media/images/31fc1223-1f59-428c-91dd-ec3df11866d1.webp)
Ả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é.
/filters:quality(82)/media/images/b021bf45-cfc6-419d-8e34-5d2db159895a.webp)
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 --downloadTạ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_imageTạo ảnh từ prompt, có thể kèm ảnh tham chiếu
edit_imageChỉnh sửa, đổi phong cách hoặc ghép ảnh có sẵn
generate_videoTạo video từ prompt, khung hình đầu hoặc tham chiếu
edit_videoThay đổi diễn biến trong video có sẵn
extend_videoNối dài video bằng cảnh quay mới
list_modelsTì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_modelChạy mọi model; đầu vào @tệp cục bộ được tải lên tự động
get_priceBáo giá trước khi chi tiêu
get_balanceXem số dư tín dụng
upload_fileBiến tệp cục bộ thành URL được lưu trữ
get_predictionLấy lại một lần tạo dài theo id
list_predictionsXem lịch sử các lần tạo của bạn
list_billingsXem từng khoản trừ tiền và hoàn tiền
get_usageTheo dõi chi tiêu và mức dùng theo ngày và mô hình
delete_predictionsXó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