Chuyển đến nội dung chính
Hướng dẫn AI

Kết nối tác nhân AI với Muse bằng Muse4AI

Tìm hiểu cách cài đặt Muse4AI trên Windows, kết nối tác nhân AI thông qua MCP, OAuth hoặc REST, và gửi tác vụ tạo hình ảnh, video Muse từ máy tính cá nhân. Hướng dẫn cũng đề cập đến việc quản lý tác vụ, kiểm soát bảo mật, các lệnh phát triển và mẹo sử dụng thực tế.

Thời gian đọc khoảng 18 phút
Kết nối tác nhân AI với Muse bằng Muse4AI

Muse4AI là gì?

Muse4AI là ứng dụng Windows chạy cục bộ, cho phép các tác nhân AI vận hành phiên Muse mà bạn đã đăng nhập. Ứng dụng kết nối các công cụ như ChatGPT, Claude, Cursor, Codex, n8n và tập lệnh tùy chỉnh với Muse thông qua REST, MCP hoặc OAuth.

Ứng dụng chạy trên chính PC của bạn và cung cấp API cục bộ tại http://127.0.0.1:47821. Các yêu cầu không được chuyển tiếp qua dịch vụ đám mây Muse4AI. Kết quả, khóa API, mã thông báo OAuth, lịch sử và thư viện cục bộ của bạn vẫn nằm trong %APPDATA%\MuseStudio.

Giao diện máy tính Muse4AI

Tính năng chính

  • Tạo hình ảnh và video: Gửi lời nhắc văn bản, tùy chọn thêm ảnh tham chiếu, chọn tài khoản và theo dõi tác vụ trong hàng đợi.
  • Tiếp tục cuộc trò chuyện: Các tác vụ trò chuyện trả về ID cuộc trò chuyện để tác nhân có thể duy trì ngữ cảnh, phát triển ý tưởng và đính kèm tệp.
  • Kéo dài video đã hoàn tất: Tiếp tục một đoạn clip đã tạo tối đa sáu bước và khoảng 60 giây cho mỗi chuỗi.
  • Chỉnh sửa video bằng ngôn ngữ tự nhiên: Đính kèm tệp MP4 và mô tả thay đổi mong muốn mà không cần cấu hình dòng thời gian chỉnh sửa truyền thống.
  • Sử dụng REST hoặc MCP: Kết nối phần mềm tác nhân qua các công cụ MCP hoặc gọi trực tiếp API REST cục bộ.
  • Ủy quyền an toàn: Sử dụng khóa API có phạm vi quyền hoặc hoàn tất quy trình OAuth bằng mã phê duyệt gồm sáu chữ số.
  • Quản lý công việc cục bộ: Xem các tác vụ đang chờ, bản xem trước, tài sản đã tạo, cài đặt kết nối và lịch sử có thể tìm kiếm trong ứng dụng máy tính.

Yêu cầu và các giới hạn quan trọng

Ứng dụng đóng gói dành cho Windows 10 hoặc Windows 11. Nếu chạy dự án từ mã nguồn, bạn cũng cần Node.js 22 trở lên.

Muse4AI là một dự án độc lập không chính thức và không liên kết, được chứng thực hoặc tài trợ bởi Meta Platforms, Inc. Ứng dụng tự động hóa phiên Muse của bạn, vì vậy hãy xem các điều khoản dịch vụ hiện hành trước khi sử dụng. Những thay đổi đối với Muse cũng có thể ảnh hưởng đến khả năng tự động hóa.

Hiện chưa có phiên bản đóng gói cho macOS và Linux được kiểm thử hoặc cung cấp. Muse4AI không có tài khoản đám mây, máy chủ đo lường từ xa hay gói thuê bao.

Cài đặt Muse4AI trên Windows

Tùy chọn 1: Sử dụng trình cài đặt

  1. Mở trang tải xuống Muse4AI.
  2. Tải xuống và chạy trình cài đặt Windows.
  3. Nếu Windows cảnh báo ứng dụng chưa được ký, hãy chọn More info, sau đó chọn Run anyway.
  4. Mở Muse4AI và đi đến Accounts.
  5. Thêm tài khoản Muse và đảm bảo tài khoản đã đăng nhập.

Tùy chọn 2: Chạy từ mã nguồn

Sao chép hoặc tải xuống kho lưu trữ, mở terminal trong thư mục gốc rồi chạy:

cd desktop
npm install
npm run build
npm start

Sau khi khởi động, giao diện máy tính sẽ mở và API cục bộ khả dụng tại http://127.0.0.1:47821.

Kết nối tác nhân AI bằng MCP và OAuth

MCP là lựa chọn trực tiếp nhất cho các ứng dụng tác nhân tương thích. Trong Muse4AI, mở Settings → API & agent. Ứng dụng cung cấp đoạn cấu hình kết nối có sẵn. Cấu hình MCP cơ bản trỏ ứng dụng khách đến điểm cuối cục bộ:

{
  "mcpServers": {
    "muse4ai": {
      "url": "http://127.0.0.1:47821/mcp"
    }
  }
}

Thêm cấu hình này vào ứng dụng khách MCP được tác nhân của bạn sử dụng. Trong quá trình ủy quyền OAuth, Muse4AI hiển thị một mã gồm sáu chữ số. Nhập mã đó trên trang chấp thuận để phê duyệt kết nối và cấp mã thông báo.

Máy chủ OAuth công bố siêu dữ liệu ủy quyền, hỗ trợ đăng ký ứng dụng khách động và tự ký các mã thông báo của mình. Biết URL MCP cục bộ là chưa đủ để phê duyệt quyền truy cập, vì người dùng cũng phải cung cấp mã được ứng dụng máy tính hiển thị.

Để xóa quyền truy cập sau này, mở Settings → API & agent → Connected apps và thu hồi ứng dụng liên quan.

Kết nối qua API REST

Đối với các tập lệnh và dịch vụ sử dụng HTTP trực tiếp, hãy tạo khóa API trong Settings → API & agent. Khóa Muse4AI bắt đầu bằng msk_. Gửi khóa dưới dạng mã thông báo bearer trong tiêu đề Authorization.

Gửi tác vụ tạo video

Yêu cầu sau tạo một tác vụ video bằng lời nhắc văn bản:

curl -X POST http://127.0.0.1:47821/v1/jobs \
  -H "Authorization: Bearer msk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"video","prompt":"a coffee cup on an oak desk, warm morning light"}'

Thay msk_YOUR_KEY bằng khóa được tạo trong ứng dụng máy tính. Tác vụ đã gửi sẽ xuất hiện trong hàng đợi bên trong ứng dụng, nơi bạn có thể theo dõi trạng thái và kiểm tra kết quả.

Quy trình tạo nội dung Muse4AI

Các thao tác REST và công cụ MCP khả dụng

  • POST /v1/jobs tạo các tác vụ hình ảnh hoặc video. Công cụ MCP tương ứng là muse_generate.
  • POST /v1/jobs với kind: "chat" tạo một tác vụ trò chuyện. Công cụ MCP tương ứng là muse_chat.
  • GET /v1/jobs liệt kê các tác vụ qua REST. Máy khách MCP có thể sử dụng muse_list_jobs.
  • GET /v1/jobs/{id} truy xuất một tác vụ cụ thể. Công cụ tương đương trong MCP là muse_get_job.
  • POST /v1/jobs/{id}/cancel hủy một tác vụ. Công cụ MCP là muse_cancel_job.
  • POST /v1/assets/{id}/extend và POST /v1/conversations/{id}/extend hỗ trợ mở rộng video. Các công cụ MCP liên quan gồm muse_extend_video và muse_get_extend.
  • GET /v1/status và GET /v1/health cung cấp thông tin dịch vụ. Máy khách MCP có thể sử dụng muse_status.

Hợp đồng API đầy đủ, có thể đọc bằng máy, có sẵn từ ứng dụng đang chạy tại GET /v1/openapi.json. Các agent hoạt động tốt hơn với tài liệu Markdown có thể đọc llms.txt.

Quy trình cơ bản cho agent

Tạo hình ảnh hoặc video

  1. Xác nhận Muse4AI đang chạy và tài khoản Muse của bạn đã có trong Accounts.
  2. Yêu cầu agent được kết nối tạo hình ảnh hoặc video và cung cấp prompt rõ ràng.
  3. Nếu cần, hãy thêm ảnh tham chiếu và chỉ định tài khoản đã cấu hình cần sử dụng.
  4. Mở hàng đợi để theo dõi tác vụ, xem trạng thái và xem trước kết quả.
  5. Tìm các sản phẩm đã hoàn tất trong thư viện cục bộ.

Tiếp tục cuộc trò chuyện

Sử dụng muse_chat hoặc tạo một tác vụ REST với kind: "chat". Hãy lưu ID cuộc trò chuyện được trả về để agent có thể tiếp tục cùng một chuỗi thay vì bắt đầu một cuộc trò chuyện riêng.

Mở rộng một clip đã hoàn tất

Sau khi video hoàn tất, hãy sử dụng endpoint mở rộng tài sản hoặc cuộc trò chuyện, hoặc yêu cầu agent MCP gọi muse_extend_video. Các phần mở rộng được giữ trong cuộc trò chuyện nơi clip gốc được tạo. Một chuỗi có thể chứa tối đa sáu bước mở rộng và đạt khoảng 60 giây.

Chỉnh sửa video hiện có

Đính kèm tệp MP4 và mô tả thay đổi mong muốn bằng ngôn ngữ tự nhiên. Muse4AI chuyển yêu cầu qua phiên Muse của bạn mà không yêu cầu cài đặt dòng thời gian hoặc kết xuất.

Mẹo nâng cao

Sử dụng phương thức ủy quyền phù hợp

Chọn OAuth khi máy khách MCP hỗ trợ ủy quyền tương tác và bạn không muốn sao chép khóa. Chọn khóa API cho các công cụ dòng lệnh, tự động hóa cục bộ và hệ thống gửi bearer token. Khóa API được giới hạn phạm vi, giới hạn tốc độ và có thể thu hồi riêng lẻ.

Bảo vệ thông tin xác thực cục bộ

Không công khai khóa msk_ trong mã nguồn, ảnh chụp màn hình, prompt được chia sẻ hoặc lịch sử shell. Khi thực tế cho phép, hãy tạo các khóa riêng cho từng máy khách, sau đó chỉ thu hồi khóa bị ảnh hưởng nếu không còn cần quyền truy cập.

Lưu giữ ID cuộc trò chuyện

Khi xây dựng tích hợp, hãy lưu ID cuộc trò chuyện được trả về từ các quy trình trò chuyện và tạo nội dung. Việc sử dụng lại ID này cho phép agent tiếp tục một chuỗi, đính kèm tệp theo ngữ cảnh và mở rộng video trong cuộc trò chuyện gốc.

Kiểm tra hợp đồng API

Thay vì đoán các trường yêu cầu và phản hồi, hãy đọc http://127.0.0.1:47821/v1/openapi.json từ ứng dụng đang chạy. Điều này đặc biệt hữu ích khi tạo máy khách có kiểu hoặc cấu hình nền tảng tự động hóa.

Kiểm tra trạng thái trước khi gửi tác vụ

Sử dụng GET /v1/status, GET /v1/health hoặc công cụ MCP muse_status để kiểm tra dịch vụ cục bộ trước khi bắt đầu quy trình dài. Sử dụng các thao tác liệt kê và truy xuất để theo dõi tác vụ, đồng thời hủy những tác vụ không còn cần thiết.

Phát triển và kiểm thử dự án

Kho lưu trữ tách biệt ứng dụng máy tính, nội dung dùng chung và hướng dẫn cho agent:

  • desktop/ chứa tiến trình chính, trình kết xuất, các API REST, MCP và OAuth, mã kiểm thử cùng mã trình cài đặt.
  • content/ chứa nội dung hướng dẫn, agent và trường hợp sử dụng được ứng dụng và website chia sẻ.
  • agent-kit/ chứa Muse4AI Skill để agent đọc và tìm hiểu cách sử dụng công cụ.

Từ thư mục desktop, hãy chạy các bước kiểm tra dự án và lệnh đóng gói cho Windows:

cd desktop
npm test
npm run typecheck
npm run package:win

Lệnh kiểm thử chạy bộ kiểm thử của kho lưu trữ, npm run typecheck kiểm tra TypeScript nghiêm ngặt, còn npm run package:win chuẩn bị tệp ZIP Windows và các đầu vào cho trình cài đặt.

Kết luận

Muse4AI cung cấp một cầu nối cục bộ giữa Muse và các agent AI hiểu REST, MCP hoặc OAuth. Sau khi ứng dụng Windows đang chạy và tài khoản Muse của bạn được kết nối, bạn có thể tạo nội dung đa phương tiện, duy trì cuộc trò chuyện, mở rộng video, chỉnh sửa tệp MP4 bằng yêu cầu ngôn ngữ tự nhiên và quản lý kết quả mà không cần trung gian đám mây Muse4AI.

Để xem thêm ảnh chụp màn hình và hướng dẫn, hãy truy cập hướng dẫn chính thức. Muse4AI được cung cấp theo giấy phép MIT.