- Hitelesítés
- Bejelentkezés az fcaai-jal (OAuth) vagy API-kulcs OAuth 2.1 (PKCE) · Bearer fcaai_live_…
- Szükséges hatókör
- generations:write
- Protokoll
- 2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
- Ár
- API-árak · USD · a sikertelen futtatások díját visszatérítjük
A ChatGPT és a Claude az fcaai-fiókoddal való bejelentkezéssel csatlakozik, kulcsmásolás nélkül. A kódeszközök is bejelentkezhetnek, vagy API-kulcsot használhatnak. A tesztkulcsokat (fcaai_test_) az éles kulcsokkal azonos módon számlázzuk. Kulcs létrehozása
Mi az MCP?
Nyílt szabvány, amellyel az AI-asszisztensek külső eszközöket használhatnak. Ha az asszisztensed egy feladatot nem tud maga elvégezni, meghívja a megfelelő eszközt egy csatlakoztatott szerveren, és visszahozza neked az eredményt. Az eszközöket az fcaai adja; neked csak beszélned kell.
Mire jó?
Alkoss a beszélgetésen belül, fülváltás nélkül. Az ismétlődő, többlépéses munkánál jelenti a legnagyobb különbséget.
- Drága feladatok előtt rákérdez. A szerver arra utasítja az asszisztenst, hogy videós és 4K-s feladatok előtt közölje az árat.
- Minden modell, minden beállítás. Az olyan beállítások, mint a képarány, az időtartam, a felbontás és a hang, az egyes modellek saját listájából származnak.
- A Canvasod eszközzé válik. A közzétett tábláid egyetlen hívással folyamatként futnak.
upload_from_urlurl: …/villa-blue-hour.jpg/u/…estimate_pricemodel: fca/upscale · tier: 2x · source 1920×1080$0.008generatemodel: fca/upscale · image: /u/… · tier: 2xqueuedget_generationwait_seconds: 50succeeded
Beállítás az asszisztensedhez
Válaszd ki az alkalmazásodat. Minden útmutatót az adott alkalmazás hivatalos dokumentációja alapján ellenőriztünk. A ChatGPT és a Claude az fcaai-fiókoddal jelentkezik be; a kódeszközök is bejelentkezhetnek, vagy API-kulcsot használhatnak.
A Claude az fcaai-fiókoddal csatlakozik, API-kulcs másolása nélkül. Egyéni összekötők a Free, Pro, Max, Team és Enterprise csomagokban működnek; a Free csomagban egyet adhatsz hozzá.
Nyisd meg az összekötőidet
A claude.ai-on vagy a Claude asztali alkalmazásban nyisd meg ezt Customize › Connectors › Add custom connectorAdd meg a címet
Név fcaai · URL https://api.fcaai.ai/mcpHa a párbeszédablak megkérdezi, hogyan azonosítja magát a Claude (OAuth-kliens), válaszd ezt Register automaticallyBejelentkezés az fcaai-jal
Megnyílik az fcaai képernyője. Válaszd ki a fiókot (személyes vagy csapat), állíts be havi korlátot, és válaszd az Engedélyezés lehetőséget. Ha be van kapcsolva a kétlépcsős azonosítás, add meg a kódodat.Bekapcsolás egy csevegésben
Az üzenetmezőben nyisd meg ezt + › Connectors és kapcsold be az fcaai-t. A Claude rákérdezhet egy eszköz futtatása előtt: válaszd az Allow once vagy az Always allow lehetőséget.
Team vagy Enterprise csomagban egy Owner (tulajdonos) mindenki számára hozzáadhatja az fcaai-t itt Organization settings › Connectors › Add › Custom › Web. Ezután minden tag a Customize › Connectors menüben a Connect lehetőséget választja, és a saját fcaai-fiókjával jelentkezik be.
Csatlakozás után az fcaai a Claude mobilalkalmazásban is működik, a Claude Code-ban pedig akkor, ha ugyanazzal a Claude-fiókkal jelentkezel be.
https://api.fcaai.ai/mcpAz fcaai a Your connectors alatt Connected állapotban jelenik meg.
Használd az fcaai-t: listázd ki a képmodelleket és az áraikat.
A modellek listázása ingyenes, így ez a teszt semmibe sem kerül.
Első lépések
Úgy beszélj az asszisztenseddel, ahogy egy embernek adnál feladatot. Az első alkalommal említsd meg az fcaai-t, hogy a megfelelő eszközökhöz nyúljon.
Példapromptok
Készíts az fcaai segítségével két 16:9-es képet egy üvegvilláról egy fenyves hegygerincen, a kék órában. Előbb mondd meg az árat.
Alakítsd át a nappalimat japandi stílusúra az fcaai segítségével, és tartsd meg az ablakokat és az elrendezést: https://example.com/room.jpg
Készíts egy 5 másodperces videót, amely a https://example.com/day.jpg képpel kezdődik, és a https://example.com/night.jpg képpel ér véget. Indítás előtt mondd meg az árát.
Skálázd fel 4K-ra a legutóbbi fcaai-renderemet.
Mutasd meg az fcaai hangjait, aztán olvasd fel ezt a bekezdést nyugodt, meleg hangon.
Készíts egy 30 másodperces instrumentális lo-fi számot egy termékvideóhoz.
Melyik fcaai-sablon készít alaprajzból renderelt képet? Futtasd a legjobbat ezen: https://example.com/plan.png.
Mennyibe kerülne az fcaai-on egy 10 másodperces, 1080p-s, hangos videó? Ne futtasd.
Mennyit költöttem az fcaai-on ebben a hónapban, és mely modellekre? Mennyi az egyenlegem?
Add át a képedet az asszisztensnek
Az fcaai-eszközök linkeket fogadnak, nem fájlmellékleteket. Ezek bármelyike működik:
Egy kép-, videó- vagy hangfájl nyilvános https-linkje (legfeljebb 50 MB). Az asszisztens közvetlenül használja, vagy előbb bemásolja az fcaai-ba ezzel: upload_from_url
Az eredmények linkje ilyen: https://fcaai.ai/o/…. Vagy csak mondd: „használd a legutóbbi renderemet”, és az asszisztens megtalálja ezzel: list_generations
A Claude Code, a Codex és a Gemini CLI fel tud tölteni egy helyi fájlt az fcaai CLI-vel, majd a kiírt linket használja:
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg # prints a link to pass to the assistantA linkeknek nyilvánosnak kell lenniük. A privát hálózatokon lévő címeket és a bejelentkezéshez kötött oldalakat elutasítjuk.
A generálások a háttérben futnak. Az asszisztens a get_generation segítségével vár (ellenőrzésenként legfeljebb 50 másodpercig), és addig ellenőriz újra, amíg az eredmény el nem készül. Ha a csevegés előbb véget ér, a feladat akkor is befejeződik, és a könyvtáradba kerül. Később rákérdezhetsz: „mutasd a legutóbbi fcaai-generálásaimat”.
Hová kerülnek az eredményekMinden eredmény letöltési linkkel együtt az fcaai-könyvtáradba kerül. A terminálos asszisztensek a fájlt közvetlenül a projektmappádba is menthetik.
Kapcsolatok és költések
Te döntöd el, melyik fiókot használja egy alkalmazás, és mennyit költhet, és ezt bármikor megváltoztathatod.
Alkalmazásonkénti havi korlát
Az fcaai bejelentkezési képernyőjén havi korlátot állíthatsz be az adott alkalmazásnak ($10, $25 vagy $100), vagy korlát nélkül engedélyezheted. Ha eléri a korlátot, a következő hónapig (UTC) nem indul új feladat. A módosításhoz vond vissza a hozzáférést, és csatlakozz újra. key_spend_cap_reached
Személyes vagy csapat
Ha egy csapat tulajdonosa vagy kezelője vagy, az alkalmazást a csapathoz is csatlakoztathatod. A futtatásai ekkor a csapat egyenlegéből fizetődnek.
Kétlépcsős azonosítás
Ha be van kapcsolva, a bejelentkezési képernyő a hitelesítő alkalmazásod kódját (vagy egy tartalékkódot) kéri, mielőtt engedélyezhetnéd a hozzáférést.
Hozzáférés megszüntetése
A Fiók › API-kulcsok › Csatlakoztatott alkalmazások menüpont minden alkalmazást felsorol, amelybe bejelentkeztél, a hozzá tartozó fiókkal és korláttal együtt. Ha visszavonod a hozzáférést, az alkalmazás azonnal leáll.
Bejelentkezve maradás
Az alkalmazások maguktól megújítják a hozzáférésüket. Ha egy alkalmazást 90 napig nem használsz, vagy eltávolítod, újra bejelentkezést kér.
API-kulcsok kódeszközökhöz
Adj minden eszköznek saját kulcsot, csak a szükséges feladatokkal és havi költési korláttal. Így egyet visszavonhatsz anélkül, hogy a többihez hozzányúlnál.
Kulcsok kezeléseEszközök
Csatlakozás után az asszisztensed 53 eszközt lát. A listázó, árazó és követő eszközök ingyenesek; a fizetős eszközök indulás előtt megmutatják az árat.
list_modelsModellek típus szerint, a beállításaidhoz tartozó árralIngyenesget_modelEgy modell az összes elfogadott opciójával (megengedett értékek, tartományok, alapértékek)Ingyenesestimate_pricePontos ár, mielőtt bármi elindulnaIngyenesaccount_balanceEgyenleg és a kulcs e havi költéseIngyenesaccount_usageNapi és modellenkénti költés egy dátumtartományraIngyenesgenerateKép, videó, hang vagy 3D bármelyik modellen (aszinkron, azonosítót ad vissza)Fizetősgenerate_image1–4 kép, akár 4K-ban, előnézeti bélyegképekkelFizetősgenerate_speechSzövegfelolvasás (MP3) a választott hangonFizetősgenerate_sfxHangeffektek, hosszal és zökkenőmentes looppalFizetősgenerate_musicZeneszámok szinttel, hosszal, stílussal és dalszöveggelFizetősgenerate_3dFotóból vagy promptból 3D-modell (GLB); a saját 3D-modelljeid remeshelése, riggelése vagy újratextúrázásaFizetőslist_voicesEgy beszédmodell hangjai, elöl a saját klónozott hangjaiddalIngyeneslist_voice_stylesKész beszédstílusok; az utasítást az extra.style_instructions mezőben add átIngyenesget_generationÁllapot, kimenetek, visszatérítés sikertelenség esetén — várakozássalIngyeneslist_generationsA legutóbbi generálásaid, állapot szerint szűrveIngyenescancel_generationMég el nem indult generálás megszakításaIngyenesupload_from_urlNyilvános kép vagy videó behozása bemenetkéntIngyenesupload_fileA csevegéshez csatolt fájlok (ChatGPT) behozása bemenetkéntIngyenescreate_upload_linkFájl feltöltése a számítógépedről (Codex, Claude Code), legfeljebb 100 MBIngyenesfcaai_toolsAz élő eszközlista, beleértve a csatlakozásod után hozzáadott eszközöket isIngyenesfcaai_callBármely aktuális eszköz futtatása, még ha az alkalmazásod még nem is listázzaFizetőslist_templatesKész receptek és a hozzájuk szükséges bemenetekIngyenesrun_templateSablon futtatása a saját értékeiddelFizetősget_template_runTöbblépéses sablonfuttatás állapotaIngyenesdecide_template_planA filmes sablon futtatásának felvételi tervének jóváhagyása vagy átírásaIngyenescancel_template_runTöbblépéses sablonfuttatás megszakításaIngyeneslist_flowsEgy receptként közzétett Canvas-táblák a bemeneteikkel és az árukkalIngyenesrun_flowFolyamat futtatása a saját értékeiddel; minden lépés a mi oldalunkon futFizetősget_flow_runEgy folyamatfuttatás lépései és kimeneteiIngyenescancel_flow_runFolyamatfuttatás megszakításaIngyenessearch_community_flowsKeresés a közösség által megosztott folyamatok közöttIngyenescreate_timelineStoryboardból rövidfilm: előnézetek, jóváhagyás, teljes minőség, ingyenes vágásFizetősget_timelineEgy jelenet-idővonal állapotaIngyenespreview_timelineOlcsó előnézetek a storyboard jeleneteiről a teljes minőség előttFizetősapprove_timelineAz előnézett jelenetek jóváhagyásaIngyenesfinalize_timelineA jóváhagyott jelenetek elkészítése teljes minőségbenFizetősexport_timelineA jelenetek összefűzése egyetlen MP4-be narrációval és zenévelIngyenesedit_videoSaját videóid vágása és összefűzése, hangsáv hozzáadásaIngyeneslist_style_kitsStílus- és márkakészletek: paletta, betűtípusok, szabályokIngyeneslist_elementsKarakterek, termékek, helyszínek és anyagokIngyenesread_planAlaprajzból helyiséglista, feltüntetett területekkel, ajtókkal és ablakokkalFizetősfinish_panorama360°-os render megtekintésre kész formába hozása: 2:1, varratmentes szélIngyeneslist_architecture_projectsAz Architecture Studio-projektjeidIngyenescreate_architecture_projectÉpítészeti projekt létrehozásaIngyenesadd_to_architecture_projectKép vagy kimenet hozzáadása egy projekthezIngyenesproduct_list_from_imageTerméklista egy render bútoraiból és burkolataibólFizetősadd_compliance_label„Reprezentatív kép” címke hozzáadása egy képhezIngyeneslist_compliance_labelsA „reprezentatív kép” címkék egy projektbenIngyeneslist_approvalsÜgyfél-jóváhagyási kérések egy táblán és azok opcióiIngyenesdecide_approvalEgy opció jóváhagyása vagy módosítás kérése megjegyzésselIngyeneslist_farm_jobs3ds Max renderfarm-feladatok: előrehaladás és költségIngyenespause_farm_jobFutó renderfarm-feladat szüneteltetéseIngyenesresume_farm_jobSzüneteltetett renderfarm-feladat folytatásaIngyenesAPI-kulcs beállításai
Kulccsal csatlakozó eszközökhöz. Minden eszközhöz külön kulcsot javaslunk.
Hatókör
A kulcs csak a kiválasztott feladatokat végezheti. Ha egyet sem választasz, minden generálástípus engedélyezett: generations:image · video · audio · 3d · upscale · llm
Havi költési korlát
A korlát elérésekor az asszisztens leáll, és ezt a hibát kapja. A korlát minden naptári hónap elején (UTC) visszaáll: key_spend_cap_reached
Gyakoriság és párhuzamosság
Alapértelmezés szerint percenként 120 kérés és egyszerre 2 feladat. Megadhatsz IP-engedélyezőlistát és lejárati dátumot is.
Biztonságos bemenetek
Az asszisztens által átadott címeknek nyilvános https-linkeknek kell lenniük; a belső hálózatokat és a privát címeket elutasítjuk.
A kulcs csak egyszer jelenik meg, és kizárólag SHA-256 hash-ként tároljuk.
Hibaelhárítás
A hibakódok az asszisztensed által látott eszközeredményben jelennek meg. Itt láthatod, mit jelentenek, és mit tegyél.
Újra bejelentkezést kér401 · invalid_token
Az alkalmazás hozzáférése lejárt, vagy visszavonták. Csatlakozz újra: a Claude-ban válaszd az összekötőnél a Reconnect lehetőséget, a Claude Code-ban futtasd a /mcp parancsot, máshol pedig távolítsd el az fcaai-t, és add hozzá újra.
Elérted a havi korlátotkey_spend_cap_reached
Az alkalmazás vagy a kulcs elhasználta a havi keretét. Emeld meg a kulcs korlátját itt: Fiók › API-kulcsok, vagy távolítsd el az alkalmazást, és csatlakoztasd újra magasabb korláttal.
Nincs elég egyenleg402 · insufficient_balance
Töltsd fel az egyenlegedet, és kérd meg az asszisztenst, hogy próbálja újra. Nem vontunk le semmit.
EgyenlegfeltöltésA modell nem érhető elmodel_unavailable
A modell foglalt vagy szünetel. Ha van tartalék útvonal, automatikusan átváltunk rá; ha nincs, próbáld újra kicsit később, vagy kérj másik modellt.
Egy beállítás figyelmen kívül maradtignored_fields
A futtatás lefutott, és az ignored_fields felsorolja az összes beállítást, amelyet az adott modell nem fogad, az okkal együtt. Kérd meg az asszisztenst, hogy a get_model segítségével nézze meg, mit fogad el a modell.
Egy értéket elutasítottunkinvalid_<field> · invalid_arguments
Az érték nem megengedett ennél a modellnél. A hiba felsorolja az engedélyezett értékeket, így az asszisztens újrapróbálhatja valamelyikkel. Nem vontunk le semmit.
Nem jelennek meg az fcaai-eszközök
Ellenőrizd, hogy a cím vége /mcp legyen. Aztán frissíts: a ChatGPT-ben a Plugins oldalon a Refresh gombbal; a Claude-ban kapcsold be az fcaai-t itt: + › Connectors; a Cursorban kapcsold be a Customize menüben; a VS Code-ban: Restart Server. Még mindig semmi? Távolítsd el az fcaai-t, és add hozzá újra.
Túl sok kérésrate_limited
Alapértelmezés szerint kapcsolatonként percenként 120 kérés, és egyes eszközöknek saját percenkénti korlátjuk is van. Várj egy percet, és próbáld újra.
Letiltva munkahelyi hálózaton
A számítógépeden futó alkalmazásoknak (Claude Code, Codex, Cursor, VS Code…) HTTPS-hozzáférés kell az api.fcaai.ai címhez, a bejelentkezés pedig megnyitja az fcaai.ai oldalt a böngésződben. Kérd meg az informatikusokat, hogy mindkettőt engedélyezzék.
Kérdések
Kerül valamibe az MCP használata?
Nem. Csak a futtatott generálásokért fizetsz, API-áron, amerikai dollárban. A listázás, az árajánlatok és az állapotlekérdezések ingyenesek.
Működik a korlátlan csomagom MCP-n keresztül?
Nem. Az API, az MCP-szerver és a bővítmények mindig az egyenlegedet használják. A korlátlan használat a Studióra, a Canvasra és a sablonokra vonatkozik a weboldalon és az alkalmazásban.
Elindíthat az asszisztens drága feladatot anélkül, hogy megkérdezne?
A ChatGPT és a Claude megkérdezhet téged, mielőtt egy eszköz lefut, a szerver pedig arra utasítja az asszisztenst, hogy videós és 4K-s feladatok előtt mondja meg az árat. Az igazi védelmet a csatlakozáskor beállított havi limit (vagy a kulcs költési korlátja) jelenti: ha eléri, új feladat nem indul.
Hol tárolódnak a kimenetek?
Az fcaai-könyvtáradban, mint minden, amit a Studióban készítesz. Az asszisztens megadja a linket, a Claude Code, a Codex és más terminálos eszközök pedig közvetlenül a mappádba menthetik a fájlt.
Bejelentkezés vagy API-kulcs: melyiket használjam?
Jelentkezz be, ha az alkalmazásod felkínálja: nincs mit másolni, kiválasztod a fiókot és egy havi limitet, és egy kattintással eltávolíthatod az alkalmazást. API-kulcsot szkriptekhez, CI-hoz és olyan környezetekhez használj, ahol senki sem tud böngészőben bejelentkezni.
Ki használhatja az MCP-szervert?
Bármelyik fcaai-fiók, egyéni vagy csapat. A futtatások az adott fiók egyenlegéből fizetődnek API-áron, csomagtól függetlenül.
Mi történik, ha egy futtatás sikertelen?
A lefoglalt összeg automatikusan visszajár. Ha egy modell szokásos útvonala sikertelen, ugyanazon az áron egy tartalék útvonalon próbálkozunk újra.


