- Ověření
- Přihlášení přes fcaai (OAuth) nebo API klíč OAuth 2.1 (PKCE) · Bearer fcaai_live_…
- Požadovaný rozsah
- generations:write
- Protokol
- 2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
- Cena
- Ceny API · USD · neúspěšná spuštění se vracejí
ChatGPT a Claude se připojují přihlášením tvým účtem fcaai, bez kopírování klíče. Nástroje pro kód se mohou také přihlásit, nebo použít API klíč. Testovací klíče (fcaai_test_) se účtují stejně jako ostré. Vytvořit klíč
Co je MCP?
Otevřený standard, který AI asistentům umožňuje používat vnější nástroje. Když tvůj asistent úkol sám nezvládne, zavolá správný nástroj na připojeném serveru a přinese ti výsledek. fcaai dodává nástroje; ty jen mluvíš.
K čemu je to dobré?
Tvoř přímo z konverzace bez přepínání karet. Největší rozdíl udělá u opakující se, vícekrokové práce.
- Před drahými úlohami se zeptá. Server asistentovi říká, aby před video a 4K úlohami uvedl cenu.
- Každý model, každé nastavení. Volby jako poměr stran, délka, rozlišení a zvuk pocházejí z vlastního seznamu každého modelu.
- Tvůj Canvas se stane nástrojem. Tabule, které publikuješ, běží jako Flow jediným voláním.
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
Nastavení pro tvého asistenta
Vyber svou aplikaci. Každý návod byl ověřen podle oficiální dokumentace dané aplikace. ChatGPT a Claude se přihlašují tvým účtem fcaai; nástroje pro kód se mohou přihlásit také, nebo použít API klíč.
Claude se připojuje tvým účtem fcaai, bez kopírování API klíče. Vlastní konektory fungují v tarifech Free, Pro, Max, Team a Enterprise; ve Free můžeš přidat jeden.
Otevři své konektory
Na claude.ai nebo v desktopové aplikaci Claude přejdi do Customize › Connectors › Add custom connectorZadej adresu
Jméno fcaai · URL https://api.fcaai.ai/mcpPokud se dialog zeptá, jak se Claude identifikuje (OAuth klient), zvol Register automaticallyPřihlášení přes fcaai
Otevře se obrazovka fcaai. Vyber účet (osobní nebo týmový), nastav měsíční limit a zvol Povolit. Pokud máš zapnuté dvoufázové ověření, zadej kód.Zapni ho v chatu
V poli pro zprávu otevři + › Connectors a zapni fcaai. Claude se může před spuštěním nástroje zeptat: zvol Allow once nebo Always allow.
V tarifu Team nebo Enterprise přidá Owner fcaai pro všechny v Organization settings › Connectors › Add › Custom › Web. Každý člen pak zvolí Connect v Customize › Connectors a přihlásí se vlastním účtem fcaai.
Po připojení funguje fcaai i v mobilní aplikaci Claude a v Claude Code, když se přihlásíš stejným účtem Claude.
https://api.fcaai.ai/mcpfcaai je uvedeno v Your connectors jako Connected.
Použij fcaai: vypiš obrázkové modely a jejich ceny.
Výpis modelů je zdarma, takže tento test nic nestojí.
První kroky
Mluv se svým asistentem tak, jako bys zadával práci člověku. Napoprvé zmiň fcaai, aby sáhl po správných nástrojích.
Ukázkové prompty
Pomocí fcaai vytvoř dva obrázky 16:9 skleněné vily na hřebeni s borovicemi v modré hodině. Nejdřív mi řekni cenu.
Přestyluj s fcaai můj obývák do stylu Japandi a zachovej okna i dispozici: https://example.com/room.jpg
Vytvoř 5sekundové video, které začíná na https://example.com/day.jpg a končí na https://example.com/night.jpg. Než začneš, řekni mi cenu.
Zvětši můj poslední render z fcaai na 4K.
Ukaž mi hlasy fcaai a pak přečti tento odstavec klidným, vřelým hlasem.
Vytvoř 30sekundovou instrumentální lo-fi skladbu do produktového videa.
Které šablony fcaai udělají z půdorysu render? Spusť tu nejlepší na https://example.com/plan.png.
Kolik by na fcaai stálo 10sekundové video v 1080p se zvukem? Nespouštěj ho.
Kolik jsem tento měsíc utratil na fcaai a za které modely? Jaký mám zůstatek?
Dej asistentovi svůj obrázek
Nástroje fcaai přijímají odkazy, ne přílohy. Funguje cokoli z tohoto:
Veřejný odkaz https na obrázek, video nebo zvukový soubor (max. 50 MB). Asistent ho použije přímo, nebo ho nejdřív zkopíruje do fcaai pomocí upload_from_url
Výsledky mají odkazy jako https://fcaai.ai/o/…. Nebo prostě řekni „použij můj poslední render“ a asistent ho najde pomocí list_generations
Claude Code, Codex a Gemini CLI umí nahrát lokální soubor pomocí fcaai CLI a použít odkaz, který vypíše:
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg # prints a link to pass to the assistantOdkazy musí být veřejné. Adresy v soukromých sítích nebo stránky za přihlášením se odmítají.
Generování běží na pozadí. Asistent čeká pomocí get_generation (až 50 sekund na jednu kontrolu) a kontroluje znovu, dokud není výsledek hotový. Když chat skončí dřív, úloha přesto doběhne a skončí ve tvé knihovně. Zeptej se později: „ukaž moje nejnovější generování na fcaai“.
Kam jdou výsledkyKaždý výsledek se uloží do tvé knihovny fcaai s odkazem ke stažení. Termináloví asistenti umí soubor uložit i rovnou do složky projektu.
Připojení a útrata
Ty volíš, který účet aplikace používá a kolik smí utratit, a můžeš to kdykoli změnit.
Měsíční limit pro každou aplikaci
Na přihlašovací obrazovce fcaai nastavíš pro danou aplikaci měsíční limit ($10, $25 nebo $100), nebo žádný limit. Po jeho dosažení se nové úlohy zastaví do dalšího měsíce (UTC). Pro změnu odeber přístup a připoj se znovu. key_spend_cap_reached
Osobní, nebo týmový
Pokud tým vlastníš nebo spravuješ, můžeš aplikaci připojit k týmu. Její spuštění se pak platí z týmového zůstatku.
Dvoufázové ověření
Pokud je zapnuté, přihlašovací obrazovka si před povolením přístupu řekne o kód z ověřovací aplikace (nebo záložní kód).
Odebrat přístup
Účet › API klíče › Připojené aplikace vypisuje každou aplikaci, do které ses přihlásil, s jejím účtem a limitem. Odeber přístup a aplikace okamžitě přestane fungovat.
Trvalé přihlášení
Aplikace si přístup obnovují samy. Pokud se aplikace 90 dní nepoužívá, nebo ji odebereš, požádá tě o nové přihlášení.
API klíče pro nástroje pro kód
Dej každému nástroji vlastní klíč jen s úlohami, které potřebuje, a s měsíčním limitem útraty. Jeden zrušíš, aniž by ses dotkl ostatních.
Spravovat klíčeNástroje
Po připojení tvůj asistent uvidí tyto nástroje (53). Nástroje pro výpis, ceny a sledování jsou zdarma; placené nástroje před startem ukážou cenu.
list_modelsModely podle typu, s cenou pro tvoje nastaveníZdarmaget_modelJeden model se všemi volbami, které přijímá (povolené hodnoty, rozsahy, výchozí hodnoty)Zdarmaestimate_pricePřesná cena dřív, než se cokoli spustíZdarmaaccount_balanceZůstatek a útrata tohoto klíče v tomto měsíciZdarmaaccount_usageÚtrata po dnech a modelech za zvolené obdobíZdarmagenerateObrázek, video, zvuk nebo 3D na libovolném modelu (asynchronně, vrací id)Placenégenerate_image1–4 obrázky, až 4K, s miniaturami náhleduPlacenégenerate_speechPřevod textu na řeč (MP3) zvoleným hlasemPlacenégenerate_sfxZvukové efekty, s délkou a plynulou smyčkouPlacenégenerate_musicHudební skladby s úrovní, délkou, stylem a textemPlacenégenerate_3dFotka nebo prompt na 3D model (GLB); remesh, rig nebo nové textury tvých vlastních 3D modelůPlacenélist_voicesHlasy pro model řeči, tvoje vlastní klonované hlasy jako prvníZdarmalist_voice_stylesHotové styly mluvy; instrukci předej jako extra.style_instructionsZdarmaget_generationStav, výstupy, vrácení při selhání – s čekánímZdarmalist_generationsTvoje nedávná generování, filtr podle stavuZdarmacancel_generationZrušit generování, které ještě nezačaloZdarmaupload_from_urlPřinést veřejný obrázek nebo video jako vstupZdarmaupload_filePřinést soubory přiložené v chatu (ChatGPT) jako vstupyZdarmacreate_upload_linkNahrát soubor z počítače (Codex, Claude Code) až do 100 MBZdarmafcaai_toolsAktuální seznam nástrojů, včetně těch přidaných po připojeníZdarmafcaai_callSpustit jakýkoli aktuální nástroj, i takový, který tvoje aplikace ještě nezobrazujePlacenélist_templatesHotové recepty a vstupy, které přijímajíZdarmarun_templateSpustit šablonu s tvými hodnotamiPlacenéget_template_runStav vícekrokového spuštění šablonyZdarmadecide_template_planSchválit nebo upravit plán záběrů při spuštění filmové šablonyZdarmacancel_template_runZrušit vícekrokové spuštění šablonyZdarmalist_flowsTabule Canvasu publikované jako jeden recept, s jejich vstupy a cenouZdarmarun_flowSpustit Flow s tvými hodnotami; každý krok běží u násPlacenéget_flow_runKroky a výstupy spuštění FlowZdarmacancel_flow_runZrušit spuštění FlowZdarmasearch_community_flowsHledat Flow sdílené komunitouZdarmacreate_timelineZe storyboardu krátký film: náhledy, schválení, plná kvalita, střih zdarmaPlacenéget_timelineStav časové osy scénZdarmapreview_timelineLevné náhledy scén ze storyboardu před plnou kvalitouPlacenéapprove_timelineSchválit náhledy scénZdarmafinalize_timelineVytvořit schválené scény v plné kvalitěPlacenéexport_timelineSpojit scény do jednoho MP4 s hlasem a hudbouZdarmaedit_videoOřezat a spojit vlastní videa, přidat zvukovou stopuZdarmalist_style_kitsStylové sady a brand kity: paleta, písma, pravidlaZdarmalist_elementsPostavy, produkty, místa a materiályZdarmaread_planZ půdorysu seznam místností s uvedenými plochami, dveřmi a oknyPlacenéfinish_panoramaPřipravit 360° render pro prohlížeč: 2:1, plynulý okrajZdarmalist_architecture_projectsTvoje projekty Architecture StudiaZdarmacreate_architecture_projectVytvořit architektonický projektZdarmaadd_to_architecture_projectPřidat obrázek nebo výstup do projektuZdarmaproduct_list_from_imageSeznam produktů z nábytku a povrchů na renderuPlacenéadd_compliance_labelPřidat k obrázku štítek „ilustrační obrázek“Zdarmalist_compliance_labelsŠtítky „ilustrační obrázek“ v projektuZdarmalist_approvalsŽádosti o schválení od klienta na tabuli a jejich možnostiZdarmadecide_approvalSchválit možnost nebo požádat o změny s poznámkouZdarmalist_farm_jobsÚlohy renderovací farmy 3ds Max: průběh a cenaZdarmapause_farm_jobPozastavit běžící úlohu renderovací farmyZdarmaresume_farm_jobObnovit pozastavenou úlohu renderovací farmyZdarmaNastavení API klíče
Pro nástroje, které se připojují klíčem. Doporučujeme samostatný klíč pro každý nástroj.
Rozsah
Klíč smí dělat jen úlohy, které vybereš. Když nevybereš nic, je povolen každý druh generování: generations:image · video · audio · 3d · upscale · llm
Měsíční limit útraty
Po dosažení limitu se asistent zastaví a dostane tuto chybu. Limit se obnovuje na začátku každého kalendářního měsíce (UTC): key_spend_cap_reached
Rychlost a souběh
Ve výchozím stavu 120 požadavků za minutu a 2 úlohy současně. Můžeš přidat seznam povolených IP a datum vypršení.
Bezpečné vstupy
Adresy, které asistent předává, musí být veřejné odkazy https; interní sítě a soukromé adresy se odmítají.
Klíč se zobrazí jednou a uchovává se jen jako hash SHA-256.
Řešení problémů
Chybové kódy se objevují ve výsledku nástroje, který vidí tvůj asistent. Tady je, co znamenají a co dělat.
Vyzváno k novému přihlášení401 · invalid_token
Přístup aplikace vypršel nebo byl odebrán. Připoj se znovu: v Claude zvol u konektoru Reconnect, v Claude Code spusť /mcp, jinde fcaai odeber a přidej znovu.
Dosažen měsíční limitkey_spend_cap_reached
Aplikace nebo klíč vyčerpaly měsíční limit. Zvyš limit klíče v Účet › API klíče, nebo aplikaci odeber a připoj znovu s vyšším limitem.
Nedostatečný zůstatek402 · insufficient_balance
Dobij si zůstatek a požádej asistenta, ať to zkusí znovu. Nic se neúčtovalo.
DobítModel nedostupnýmodel_unavailable
Model je vytížený nebo pozastavený. Pokud existuje záložní cesta, přepneme na ni automaticky; jinak to zkus za chvíli znovu nebo si řekni o jiný model.
Nastavení bylo ignorovánoignored_fields
Spuštění proběhlo a ignored_fields vypíše každé nastavení, které model nepřijímá, i s důvodem. Požádej asistenta, ať v get_model zkontroluje, co model přijímá.
Hodnota byla odmítnutainvalid_<field> · invalid_arguments
Hodnota není pro daný model povolená. Chyba vypíše povolené hodnoty, takže asistent to může zkusit znovu s některou z nich. Nic se neúčtovalo.
Nezobrazují se žádné nástroje fcaai
Zkontroluj, že adresa končí na /mcp. Pak obnov: v ChatGPT Refresh na stránce Plugins; v Claude zapni fcaai v + › Connectors; v Cursoru ho zapni v Customize; ve VS Code Restart Server. Pořád nic? Odeber fcaai a přidej ho znovu.
Příliš mnoho požadavkůrate_limited
Ve výchozím stavu 120 požadavků za minutu na připojení a některé nástroje mají vlastní minutový limit. Počkej minutu a zkus to znovu.
Zablokováno v pracovní síti
Aplikace na tvém počítači (Claude Code, Codex, Cursor, VS Code…) potřebují přístup HTTPS k api.fcaai.ai a přihlášení otevírá fcaai.ai v prohlížeči. Požádej IT, ať povolí obojí.
Otázky
Stojí používání MCP něco navíc?
Ne. Platíš jen za generování, která spustíš, za ceny API v amerických dolarech. Výpisy, cenové odhady a kontroly stavu jsou zdarma.
Funguje můj neomezený tarif přes MCP?
Ne. API, MCP server i pluginy vždy čerpají z tvého zůstatku. Neomezené použití platí pro Studio, Canvas a šablony na webu a v aplikaci.
Může asistent spustit drahou úlohu, aniž by se zeptal?
ChatGPT i Claude se tě mohou před spuštěním nástroje zeptat a server asistentovi říká, aby před video a 4K úlohami uvedl cenu. Skutečnou pojistkou je měsíční limit, který nastavíš při připojení (nebo limit útraty klíče): jakmile je dosažen, žádná nová úloha nezačne.
Kde jsou výstupy uložené?
V tvé knihovně fcaai, stejně jako vše, co vytvoříš ve Studiu. Asistent ti dá odkaz a Claude Code, Codex a další terminálové nástroje umí soubor uložit rovnou do tvé složky.
Přihlášení, nebo API klíč: co použít?
Přihlas se, když to aplikace nabízí: nemusíš kopírovat žádný klíč, vybereš účet a měsíční limit a aplikaci odebereš jedním kliknutím. API klíč použij pro skripty, CI a prostředí, kde se nikdo nemůže přihlásit přes prohlížeč.
Kdo může MCP server používat?
Jakýkoli účet fcaai, osobní i týmový. Spuštění se platí ze zůstatku daného účtu za ceny API, bez ohledu na tarif.
Co se stane, když spuštění selže?
Rezervovaná částka se automaticky vrátí. Když obvyklá cesta modelu selže, zkusíme to znovu přes záložní cestu za stejnou cenu.


