Unganisha Mawakala wa AI na Muse kupitia Muse4AI

Muse4AI ni nini?

Muse4AI ni programu ya Windows ya ndani inayowezesha mawakala wa AI kutumia kipindi chako cha Muse kilichoingia. Inaunganisha zana kama ChatGPT, Claude, Cursor, Codex, n8n, na hati maalum na Muse kupitia REST, MCP, au OAuth.

Programu inaendeshwa kwenye PC yako mwenyewe na hutoa API yake ya ndani kwenye http://127.0.0.1:47821. Maombi hayapitishwi kupitia huduma ya wingu ya Muse4AI. Matokeo yako, funguo za API, tokeni za OAuth, historia, na maktaba ya ndani hubaki chini ya %APPDATA%\MuseStudio.

Uwezo mkuu

• Tengeneza picha na video: Tuma maelekezo ya maandishi, ongeza kwa hiari picha za marejeleo, chagua akaunti, na fuatilia kazi kwenye foleni.
• Endeleza mazungumzo: Kazi za gumzo hurejesha kitambulisho cha mazungumzo ili wakala aweze kuhifadhi muktadha, kuboresha wazo, na kuambatisha faili.
• Panua video zilizokamilika: Endeleza klipu iliyotengenezwa kwa hadi hatua sita na takriban sekunde 60 kwa kila mfululizo.
• Hariri video kwa lugha ya kawaida: Ambatisha MP4 na eleza mabadiliko unayotaka bila kusanidi ratiba ya jadi ya uhariri.
• Tumia REST au MCP: Unganisha programu ya wakala kupitia zana za MCP au piga API ya ndani ya REST moja kwa moja.
• Thibitisha kwa usalama: Tumia ufunguo wa API wenye ruhusa maalum au kamilisha mtiririko wa OAuth kwa msimbo wa tarakimu sita wa uidhinishaji.
• Dhibiti kazi ndani ya kifaa: Kagua kazi zilizo kwenye foleni, hakikisho, vipengee vilivyotengenezwa, mipangilio ya muunganisho, na historia inayoweza kutafutwa kwenye programu ya eneo-kazi.

Mahitaji na vikwazo muhimu

Programu iliyofungashwa imekusudiwa kwa Windows 10 au Windows 11. Ukiendesha mradi kutoka kwenye msimbo wa chanzo, unahitaji pia Node.js 22 au mpya zaidi.

Muse4AI ni mradi huru usio rasmi na hauhusiani na, haujaidhinishwa na, wala kudhaminiwa na Meta Platforms, Inc. Huendesha kipindi chako cha Muse, kwa hiyo kagua masharti yanayotumika ya huduma kabla ya kuutegemea. Mabadiliko kwenye Muse yanaweza pia kuathiri uendeshaji huo wa kiotomatiki.

Matoleo yaliyofungashwa ya macOS na Linux hayajajaribiwa wala kutolewa kwa sasa. Muse4AI haina akaunti ya wingu, seva ya telemetry, au usajili.

Sakinisha Muse4AI kwenye Windows

Chaguo la 1: Tumia kisakinishi

1. Fungua ukurasa wa upakuaji wa Muse4AI.
2. Pakua na uendeshe kisakinishi cha Windows.
3. Windows ikionya kuwa programu haijasainiwa, chagua More info kisha Run anyway.
4. Fungua Muse4AI na uende kwenye Accounts.
5. Ongeza akaunti yako ya Muse na uhakikishe kuwa kipindi chake kimeingia.

Chaguo la 2: Endesha kutoka kwenye msimbo wa chanzo

Fanya clone au pakua hazina, fungua terminal kwenye saraka yake ya mzizi, kisha endesha:

cd desktop
npm install
npm run build
npm start

Baada ya kuanza, kiolesura cha eneo-kazi hufunguka na API ya ndani hupatikana kwenye http://127.0.0.1:47821.

Unganisha wakala wa AI kwa MCP na OAuth

MCP ndiyo chaguo la moja kwa moja zaidi kwa wateja wa mawakala wanaooana. Kwenye Muse4AI, fungua Settings → API & agent. Programu hutoa kipande cha usanidi kilicho tayari kutumika. Usanidi wa msingi wa MCP humwelekeza mteja kwenye kituo cha ndani:

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

Ongeza usanidi huu kwenye mteja wa MCP unaotumiwa na wakala wako. Wakati wa uidhinishaji wa OAuth, Muse4AI huonyesha msimbo wa tarakimu sita. Weka msimbo huo kwenye ukurasa wa ridhaa ili kuidhinisha muunganisho na kutoa tokeni.

Seva ya OAuth huchapisha metadata yake ya uidhinishaji, inasaidia usajili wa mteja unaobadilika, na husaini tokeni zake yenyewe. Kujua URL ya ndani ya MCP pekee hakutoshi kuidhinisha ufikiaji kwa sababu mtumiaji lazima pia atoe msimbo unaoonyeshwa na programu ya eneo-kazi.

Ili kuondoa ufikiaji baadaye, fungua Settings → API & agent → Connected apps na ubatilishe programu husika.

Unganisha kupitia API ya REST

Kwa hati na huduma zinazotumia HTTP moja kwa moja, tengeneza ufunguo wa API kutoka Settings → API & agent. Funguo za Muse4AI huanza na msk_. Tuma ufunguo huo kama tokeni ya bearer kwenye kichwa cha Authorization.

Tuma kazi ya kutengeneza video

Ombi lifuatalo huunda kazi ya video kwa kutumia agizo la maandishi:

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

Badilisha msk_YOUR_KEY kwa ufunguo ulioundwa na programu ya eneo-kazi. Kazi iliyotumwa huonekana kwenye foleni ya ndani ya programu, ambapo unaweza kufuatilia hali yake na kukagua matokeo.

Shughuli za REST na zana za MCP zinazopatikana

• POST /v1/jobs huunda kazi za picha au video. Zana inayolingana ya MCP ni muse_generate.
• POST /v1/jobs yenye kind: "chat" huunda kazi ya mazungumzo. Zana inayolingana ya MCP ni muse_chat.
• GET /v1/jobs huorodhesha kazi kupitia REST. Wateja wa MCP wanaweza kutumia muse_list_jobs.
• GET /v1/jobs/{id} hupata kazi mahususi. Sawa yake katika MCP ni muse_get_job.
• POST /v1/jobs/{id}/cancel hughairi kazi. Zana ya MCP ni muse_cancel_job.
• POST /v1/assets/{id}/extend na POST /v1/conversations/{id}/extend zinawezesha kuongeza video. Zana zinazohusiana za MCP ni pamoja na muse_extend_video na muse_get_extend.
• GET /v1/status na GET /v1/health huripoti taarifa za huduma. Wateja wa MCP wanaweza kutumia muse_status.

Mkataba kamili wa API unaoweza kusomeka na mashine unapatikana kutoka kwenye programu inayoendesha kupitia GET /v1/openapi.json. Mawakala wanaofanya kazi vizuri zaidi na nyaraka za Markdown wanaweza kusoma llms.txt.

Mtiririko wa msingi wa kazi za wakala

Unda picha au video

1. Thibitisha kuwa Muse4AI inaendesha na akaunti yako ya Muse inapatikana chini ya Accounts.
2. Muombe wakala aliyeunganishwa kuunda picha au video na utoe kidokezo wazi.
3. Ikihitajika, jumuisha picha za marejeo na ueleze ni akaunti gani iliyosanidiwa itumike.
4. Fungua foleni ili kufuatilia kazi, kuona hali yake na kuhakiki matokeo.
5. Pata kazi zilizokamilika katika maktaba ya ndani.

Endeleza mazungumzo

Tumia muse_chat au unda kazi ya REST yenye kind: "chat". Hifadhi kitambulisho cha mazungumzo kilichorejeshwa ili wakala aweze kuendelea na uzi uleule badala ya kuanzisha mazungumzo tofauti.

Ongeza klipu iliyokamilika

Baada ya video kukamilika, tumia sehemu ya mwisho ya kuongeza ya kipengee au mazungumzo, au muombe wakala wa MCP aitumie muse_extend_video. Viendelezi hubaki katika mazungumzo ambako klipu ya awali iliundwa. Msururu unaweza kuwa na hadi hatua sita za kuongeza na kufikia takriban sekunde 60.

Hariri video iliyopo

Ambatisha MP4 na ueleze mabadiliko unayotaka kwa lugha ya kawaida. Muse4AI hupitisha ombi kupitia kipindi chako cha Muse bila kuhitaji mipangilio ya ratiba ya matukio au uwasilishaji.

Vidokezo vya kina

Tumia njia sahihi ya idhini

Chagua OAuth wakati mteja wako wa MCP unaunga mkono idhini shirikishi na hutaki kunakili ufunguo. Chagua ufunguo wa API kwa zana za mstari wa amri, uendeshaji otomatiki wa ndani na mifumo inayotuma tokeni za bearer. Vifunguo vya API vina mipaka ya matumizi, vinawekewa kikomo cha kasi na vinaweza kubatilishwa kibinafsi.

Linda vitambulisho vya ndani

Usichapishe ufunguo wa msk_ katika udhibiti wa msimbo chanzo, picha za skrini, vidokezo vilivyoshirikiwa au historia ya ganda la amri. Inapowezekana, unda funguo tofauti kwa wateja tofauti, kisha batilisha tu ufunguo ulioathiriwa ikiwa ufikiaji hauhitajiki tena.

Hifadhi vitambulisho vya mazungumzo

Unapounda muunganisho, hifadhi kitambulisho cha mazungumzo kinachorejeshwa na mtiririko wa mazungumzo na uundaji. Kukitumia tena humwezesha wakala kuendelea na uzi, kuambatisha faili kwa muktadha na kuongeza video katika mazungumzo yake ya awali.

Kagua mkataba wa API

Badala ya kukisia sehemu za ombi na jibu, soma http://127.0.0.1:47821/v1/openapi.json kutoka kwenye programu inayoendesha. Hii ni muhimu hasa unapounda mteja wenye aina maalum au kusanidi jukwaa la uendeshaji otomatiki.

Fuatilia hali kabla ya kutuma kazi

Tumia GET /v1/status, GET /v1/health au zana ya MCP ya muse_status kukagua huduma ya ndani kabla ya kuanza mtiririko mrefu wa kazi. Tumia shughuli za kuorodhesha na kupata kufuatilia kazi, na ughairi kazi ambayo haihitajiki tena.

Tengeneza na ujaribu mradi

Hazina inatenganisha programu ya eneo-kazi, maudhui yaliyoshirikiwa na maagizo ya mawakala:

• desktop/ ina mchakato mkuu, kionyeshi, API za REST, MCP na OAuth, majaribio na msimbo wa kisakinishi.
• content/ ina maandishi ya mwongozo, wakala na matukio ya matumizi yanayoshirikiwa na programu na tovuti.
• agent-kit/ ina Skill ya Muse4AI ambayo mawakala wanaweza kusoma ili kujifunza jinsi ya kutumia zana.

Ukiwa katika saraka ya desktop, endesha ukaguzi wa mradi na amri ya kufungasha kwa Windows:

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

Amri ya majaribio huendesha mkusanyiko wa majaribio wa hazina, npm run typecheck hukagua TypeScript kali, na npm run package:win huandaa ZIP ya Windows pamoja na vipengele vya kisakinishi.

Hitimisho

Muse4AI hutoa daraja la ndani kati ya Muse na mawakala wa AI wanaoelewa REST, MCP au OAuth. Programu ya Windows inapokuwa inaendesha na akaunti yako ya Muse imeunganishwa, unaweza kuunda maudhui ya media, kudumisha mazungumzo, kuongeza video, kuhariri faili za MP4 kupitia maombi ya lugha asilia na kudhibiti matokeo bila mpatanishi wa wingu wa Muse4AI.

Kwa picha zaidi za skrini na mwongozo, tembelea mwongozo rasmi. Muse4AI inapatikana chini ya leseni ya MIT.