Xhuma Ama-ejenti e-AI ku-Muse nge-Muse4AI

Yini i-Muse4AI?

I-Muse4AI iwuhlelo lokusebenza lwasendaweni lwe-Windows oluvumela ama-agent e-AI ukuthi asebenzise iseshini yakho ye-Muse ongene kuyo. Ixhuma amathuluzi afana ne-ChatGPT, Claude, Cursor, Codex, n8n, nemibhalo yangokwezifiso ku-Muse nge-REST, MCP, noma i-OAuth.

Uhlelo lokusebenza lusebenza ku-PC yakho futhi lunikeza i-API yalo yasendaweni ku-http://127.0.0.1:47821. Izicelo azidluliswa ngesevisi yamafu ye-Muse4AI. Imiphumela yakho, okhiye be-API, amathokheni e-OAuth, umlando, nelabhulali yasendaweni kuhlala ngaphansi kwe-%APPDATA%\MuseStudio.

Amakhono abalulekile

• Yakha izithombe namavidiyo: Thumela imiyalelo yombhalo, faka izithombe eziyisithenjwa uma kudingeka, khetha i-akhawunti, bese uqapha umsebenzi kulayini.
• Qhubeka nezingxoxo: Imisebenzi yengxoxo ibuyisa i-ID yengxoxo ukuze i-agent igcine umongo, iqhubeke nokuthuthukisa umbono, futhi inamathisele amafayela.
• Nweba amavidiyo aqediwe: Qhubeka nesiqeshana esikhiqiziwe izinyathelo ezingafika kweziyisithupha, cishe imizuzwana engu-60 ngeketango ngalinye.
• Hlela ividiyo ngolimi lwemvelo: Namathisela i-MP4 bese uchaza izinguquko ozifunayo ngaphandle kokulungisa umugqa wesikhathi wokuhlela wendabuko.
• Sebenzisa i-REST noma i-MCP: Xhuma isoftware yama-agent ngamathuluzi e-MCP noma ushayele i-REST API yasendaweni ngokuqondile.
• Gunyaza ngokuphepha: Sebenzisa ukhiye we-API onobubanzi obulinganiselwe noma uqedele inqubo ye-OAuth ngekhodi yokugunyaza enamadijithi ayisithupha.
• Phatha umsebenzi endaweni: Buyekeza imisebenzi esemgqeni, ukubuka kuqala, amafa akhiqiziwe, izilungiselelo zokuxhumana, nomlando oseshwayo kuhlelo lokusebenza lwedeskithophu.

Izidingo nemikhawulo ebalulekile

Uhlelo lokusebenza oluhlanganisiwe luhloselwe i-Windows 10 noma i-Windows 11. Uma usebenzisa iphrojekthi kusuka kukhodi yomthombo, udinga futhi i-Node.js 22 noma entsha.

I-Muse4AI iphrojekthi ezimele engekho emthethweni futhi ayihlangene ne-Meta Platforms, Inc., ayigunyazwanga yiyo, futhi ayixhaswa yiyo. Izenzela iseshini yakho ye-Muse, ngakho buyekeza imigomo yesevisi esebenzayo ngaphambi kokuyithemba. Izinguquko ku-Muse nazo zingathinta lokhu kuzenzakalela.

Izinhlobo ezihlanganisiwe ze-macOS ne-Linux azihloliwe noma azinikezwanga okwamanje. I-Muse4AI ayinayo i-akhawunti yamafu, iseva ye-telemetry, noma okubhaliselwe.

Faka i-Muse4AI ku-Windows

Inketho 1: Sebenzisa isifaki

1. Vula ikhasi lokulanda i-Muse4AI.
2. Landa bese usebenzisa isifaki se-Windows.
3. Uma i-Windows ixwayisa ngokuthi uhlelo lokusebenza alusayiniwe, khetha More info bese ukhetha Run anyway.
4. Vula i-Muse4AI bese uya ku-Accounts.
5. Faka i-akhawunti yakho ye-Muse futhi uqinisekise ukuthi iseshini yayo ingenile.

Inketho 2: Sebenzisa kusuka kukhodi yomthombo

Clone noma landa i-repository, vula itheminali kumkhombandlela wayo oyimpande, bese usebenzisa:

cd desktop
npm install
npm run build
npm start

Ngemva kokuqala, isixhumi esibonakalayo sedeskithophu siyavuleka futhi i-API yasendaweni itholakala ku-http://127.0.0.1:47821.

Xhuma i-agent ye-AI nge-MCP ne-OAuth

I-MCP iyinketho eqondile kakhulu kumaklayenti ama-agent ahambisanayo. Ku-Muse4AI, vula Settings → API & agent. Uhlelo lokusebenza lunikeza isiqeshana sokuxhuma esilungiswe kusengaphambili. Ukucushwa okuyisisekelo kwe-MCP kukhomba iklayenti endaweni yasendaweni:

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

Faka lokhu kucushwa kuklayenti le-MCP elisetshenziswa yi-agent yakho. Ngesikhathi sokugunyaza nge-OAuth, i-Muse4AI ibonisa ikhodi enamadijithi ayisithupha. Faka leyo khodi ekhasini lokuvuma ukuze uvumele ukuxhumana futhi ukhiphe ithokheni.

U-OAuth server ushicilela imethadatha yakhe yokugunyaza, usekela ukubhaliswa kwamaklayenti ashukumisayo, futhi usayina amathokheni akhe. Ukwazi i-URL ye-MCP yasendaweni akwanele ukuvumela ukufinyelela ngoba umsebenzisi kufanele anikeze nekhodi eboniswa uhlelo lokusebenza lwedeskithophu.

Ukuze ususe ukufinyelela kamuva, vula Settings → API & agent → Connected apps bese uhoxisa uhlelo lokusebenza olufanele.

Xhuma nge-REST API

Emibhalweni nasezinsizeni ezisebenzisa i-HTTP ngokuqondile, dala ukhiye we-API ku-Settings → API & agent. Okhiye be-Muse4AI baqala ngo-msk_. Thumela ukhiye njengethokheni ye-bearer kusihloko se-Authorization.

Thumela umsebenzi wokukhiqiza ividiyo

Isicelo esilandelayo sakha umsebenzi wevidiyo onomyalo wombhalo:

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"}'

Faka esikhundleni se-msk_YOUR_KEY ngokhiye owakhiwe uhlelo lokusebenza lwedeskithophu. Umsebenzi othunyelwe uvela kulayini wangaphakathi kuhlelo lokusebenza, lapho ungalandela khona isimo sawo futhi uhlole umphumela.

Imisebenzi ye-REST namathuluzi e-MCP atholakalayo

• POST /v1/jobs idala imisebenzi yezithombe noma yamavidiyo. Ithuluzi le-MCP elihambisanayo ngu-muse_generate.
• POST /v1/jobs ene-kind: "chat" idala umsebenzi wengxoxo. Ithuluzi le-MCP elihambisanayo ngu-muse_chat.
• GET /v1/jobs ibala imisebenzi nge-REST. Amaklayenti e-MCP angasebenzisa i-muse_list_jobs.
• GET /v1/jobs/{id} ithola umsebenzi othile. Okulingana nakho ku-MCP ngu-muse_get_job.
• POST /v1/jobs/{id}/cancel ikhansela umsebenzi. Ithuluzi le-MCP ngu-muse_cancel_job.
• POST /v1/assets/{id}/extend kanye ne-POST /v1/conversations/{id}/extend kusekela ukunweba amavidiyo. Amathuluzi e-MCP ahlobene afaka i-muse_extend_video ne-muse_get_extend.
• GET /v1/status kanye ne-GET /v1/health kubika ulwazi lwesevisi. Amaklayenti e-MCP angasebenzisa i-muse_status.

Inkontileka ephelele ye-API efundeka ngomshini iyatholakala kuhlelo lokusebenza olusebenzayo ku-GET /v1/openapi.json. Ama-agent asebenza kangcono ngemibhalo ye-Markdown angafunda i-llms.txt.

Ukuhamba komsebenzi okuyisisekelo kwama-agent

Dala isithombe noma ividiyo

1. Qinisekisa ukuthi i-Muse4AI iyasebenza nokuthi i-akhawunti yakho ye-Muse iyatholakala ngaphansi kwe-Accounts.
2. cela i-agent exhunyiwe ukuthi idale isithombe noma ividiyo, bese unikeza i-prompt ecacile.
3. Uma kudingeka, faka izithombe eziyizithenjwa bese ucacisa ukuthi iyiphi i-akhawunti emisiwe okufanele isetshenziswe.
4. Vula ulayini ukuze ulandele umsebenzi, ubuke isimo sawo, futhi ubuke kuqala umphumela.
5. Thola umsebenzi oqediwe kulabhulali yasendaweni.

Qhubeka nengxoxo

Sebenzisa i-muse_chat noma udale umsebenzi we-REST one-kind: "chat". Gcina i-ID yengxoxo ebuyisiwe ukuze i-agent iqhubeke nentambo efanayo esikhundleni sokuqala ingxoxo ehlukile.

Yelula isiqeshana esiqediwe

Ngemva kokuba ividiyo iqediwe, sebenzisa i-endpoint yokwelula ye-asset noma yengxoxo, noma ucele i-agent ye-MCP ukuthi ibize i-muse_extend_video. Izandiso zihlala engxoxweni lapho isiqeshana sokuqala sadalwa khona. Uchungechunge lungaqukatha izinyathelo zokwelula ezingafika kweziyisithupha futhi lufinyelele cishe kumasekhondi angu-60.

Hlela ividiyo ekhona

Namathisela i-MP4 bese uchaza ushintsho oluceliwe ngolimi olucacile. I-Muse4AI idlulisa isicelo ngeseshini yakho ye-Muse ngaphandle kokudinga izilungiselelo zomugqa wesikhathi noma zokunikezela.

Amathiphu athuthukile

Sebenzisa indlela efanele yokugunyaza

Khetha i-OAuth lapho iklayenti lakho le-MCP lisekela ukugunyazwa okusebenzisanayo futhi ungafuni ukukopisha ukhiye. Khetha ukhiye we-API wamathuluzi omugqa womyalo, i-automation yasendaweni, namasistimu athumela amathokheni e-bearer. Okhiye be-API banobubanzi obunqunyiwe, banemikhawulo yezinga, futhi bangahoxiswa ngabanye.

Vikela iziqinisekiso zasendaweni

Ungashicileli ukhiye we-msk_ ku-source control, ezithombeni-skrini, kuma-prompt abiwe, noma emlandweni we-shell. Dala okhiye abahlukene bamaklayenti ahlukene lapho kusebenza khona, bese uhoxisa kuphela ukhiye othintekile uma ukufinyelela kungasadingeki.

Gcina ama-ID ezingxoxo

Lapho wakha i-integration, gcina i-ID yengxoxo ebuyiswa ukugeleza kwengxoxo nokudala. Ukuyisebenzisa futhi kuvumela i-agent ukuthi iqhubeke nentambo, inamathisele amafayela anomongo, futhi yelule ividiyo engxoxweni yayo yokuqala.

Hlola inkontileka ye-API

Esikhundleni sokuqagela izinkambu zezicelo nezimpendulo, funda i-http://127.0.0.1:47821/v1/openapi.json ohlelweni olusebenzayo. Lokhu kuwusizo kakhulu lapho udala iklayenti elinezinhlobo ezicacisiwe noma ulungiselela inkundla ye-automation.

Hlola isimo ngaphambi kokuthumela umsebenzi

Sebenzisa i-GET /v1/status, i-GET /v1/health, noma ithuluzi le-MCP elithi muse_status ukuhlola isevisi yasendaweni ngaphambi kokuqala ukuhamba komsebenzi okude. Sebenzisa imisebenzi yokubala nokuthola ukuqapha imisebenzi, futhi ukhansele umsebenzi ongasadingeki.

Thuthukisa futhi uhlole iphrojekthi

Indawo yokugcina ihlukanisa uhlelo lokusebenza lwedeskithophu, okuqukethwe okwabiwe, nemiyalelo yama-agent:

• desktop/ iqukethe inqubo eyinhloko, i-renderer, ama-API e-REST, e-MCP nawe-OAuth, izivivinyo, nekhodi yesifaki.
• content/ iqukethe umbhalo wezinkomba, ama-agent, namacala okusetshenziswa okwabiwe uhlelo lokusebenza newebhusayithi.
• agent-kit/ iqukethe i-Muse4AI Skill ama-agent angayifunda ukuze afunde ukusebenzisa ithuluzi.

Kusuka kufolda ye-desktop, sebenzisa ukuhlolwa kwephrojekthi nomyalo wokupakisha we-Windows:

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

Umyalo wokuhlola usebenzisa iqoqo lezivivinyo lendawo yokugcina, i-npm run typecheck ihlola i-TypeScript eqinile, kanti i-npm run package:win ilungiselela i-ZIP ye-Windows nezinto zokufaka.

Isiphetho

I-Muse4AI inikeza ibhuloho lendawo phakathi kwe-Muse nama-agent e-AI aqonda i-REST, i-MCP, noma i-OAuth. Uma uhlelo lokusebenza lwe-Windows selusebenza futhi i-akhawunti yakho ye-Muse ixhunyiwe, ungadala imidiya, ulondoloze izingxoxo, welule amavidiyo, uhlele amafayela e-MP4 ngezicelo zolimi lwemvelo, futhi uphathe imiphumela ngaphandle komxhumanisi wefu we-Muse4AI.

Ukuze uthole ezinye izithombe-skrini nesiqondiso, vakashela umhlahlandlela osemthethweni. I-Muse4AI iyatholakala ngaphansi kwelayisensi ye-MIT.