- Автентифікація
- Вхід через fcaai (OAuth) або ключ API OAuth 2.1 (PKCE) · Bearer fcaai_live_…
- Потрібна область доступу
- generations:write
- Протокол
- 2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
- Ціна
- Ціни API · USD · невдалі запуски повертаються
ChatGPT і Claude підключаються через вхід із твоїм обліковим записом fcaai — копіювати ключ не потрібно. Інструменти для коду теж можуть входити або використовувати ключ API. Тестові ключі (fcaai_test_) оплачуються так само, як робочі. Створити ключ
Що таке MCP?
Відкритий стандарт, що дає ШІ-асистентам змогу користуватися зовнішніми інструментами. Коли асистент не може виконати завдання сам, він викликає потрібний інструмент на підключеному сервері й приносить тобі результат. fcaai надає інструменти; ти просто розмовляєш.
Для чого це добре?
Створюй просто в розмові, не перемикаючи вкладок. Найбільша різниця — у повторюваній багатокроковій роботі.
- Питає перед дорогими завданнями. Сервер наказує асистентові називати ціну перед відео- та 4K-завданнями.
- Кожна модель, кожне налаштування. Параметри на кшталт співвідношення сторін, тривалості, роздільності й звуку беруться з власного списку кожної моделі.
- Твій Canvas стає інструментом. Опубліковані тобою дошки запускаються як Flow одним викликом.
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
Налаштування для твого асистента
Обери свій застосунок. Кожен посібник звірено з офіційною документацією цього застосунку. ChatGPT і Claude входять із твоїм обліковим записом fcaai; інструменти для коду теж можуть входити або використовувати ключ API.
Claude підключається з твоїм обліковим записом fcaai — копіювати ключ API не потрібно. Власні конектори працюють на планах Free, Pro, Max, Team та Enterprise; на Free можна додати один.
Відкрий конектори
На claude.ai або в настільному застосунку Claude перейди до Customize › Connectors › Add custom connectorВведи адресу
Назва fcaai · URL https://api.fcaai.ai/mcpЯкщо діалог запитає, як Claude себе ідентифікує (клієнт OAuth), обери Register automaticallyУвійди через fcaai
Відкриється екран fcaai. Обери обліковий запис (особистий або командний), встанови місячний ліміт і натисни «Дозволити». Якщо ввімкнено двоетапну перевірку, введи код.Увімкни в чаті
У полі повідомлення відкрий + › Connectors і ввімкни fcaai. Claude може питати перед запуском інструмента: обери Allow once або Always allow.
На Team чи Enterprise власник (Owner) додає fcaai для всіх у Organization settings › Connectors › Add › Custom › Web. Після цього кожен учасник натискає Connect у Customize › Connectors і входить із власним обліковим записом fcaai.
Після підключення fcaai працює також у мобільному застосунку Claude та в Claude Code, якщо ввійти з тим самим обліковим записом Claude.
https://api.fcaai.ai/mcpfcaai є в списку Your connectors зі статусом Connected.
Використай fcaai: покажи список моделей зображень і їхні ціни.
Перелік моделей безкоштовний, тож ця перевірка нічого не коштує.
Перші кроки
Розмовляй з асистентом так, як ставив би завдання людині. Першого разу згадай fcaai, щоб він узявся за потрібні інструменти.
Приклади промптів
Через fcaai створи два зображення 16:9: скляна вілла на сосновому гребені в синю годину. Спершу назви ціну.
Через fcaai переоформ мою вітальню в стилі джапанді, зберігши вікна й планування: https://example.com/room.jpg
Створи 5-секундне відео, що починається з https://example.com/day.jpg і закінчується на https://example.com/night.jpg. Перед початком назви ціну.
Збільш мій останній рендер із fcaai до 4K.
Покажи голоси fcaai, а тоді прочитай цей абзац спокійним теплим голосом.
Створи 30-секундний інструментальний lo-fi трек для відео про товар.
Які шаблони fcaai перетворюють план поверху на рендер? Запусти найкращий на https://example.com/plan.png.
Скільки коштуватиме 10-секундне відео 1080p зі звуком у fcaai? Не запускай.
Скільки я витратив у fcaai цього місяця й на які моделі? Який у мене баланс?
Дай асистентові своє зображення
Інструменти fcaai приймають посилання, а не вкладені файли. Підійде будь-що з цього:
Публічне посилання https на зображення, відео чи аудіофайл (до 50 МБ). Асистент використовує його напряму або спершу копіює у fcaai через upload_from_url
Результати мають посилання на кшталт https://fcaai.ai/o/…. Або просто скажи «використай мій останній рендер» — і асистент знайде його через list_generations
Claude Code, Codex і Gemini CLI можуть завантажити локальний файл через fcaai CLI й використати посилання, яке він виведе:
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg # prints a link to pass to the assistantПосилання мають бути публічними. Адреси в приватних мережах і сторінки, що потребують входу, відхиляються.
Генерації виконуються у фоні. Асистент чекає через get_generation (до 50 секунд на перевірку) і перевіряє знову, доки результат не буде готовий. Якщо чат закінчиться раніше, завдання однаково завершиться й потрапить у твою бібліотеку. Запитай пізніше: «покажи мої останні генерації fcaai».
Куди потрапляють результатиКожен результат зберігається у твоїй бібліотеці fcaai з посиланням для завантаження. Термінальні асистенти можуть також зберегти файл просто в теку проєкту.
Підключення й витрати
Ти обираєш, яким обліковим записом користується застосунок і скільки він може витратити, — і можеш будь-коли передумати.
Місячний ліміт на застосунок
На екрані входу fcaai ти встановлюєш місячний ліміт для цього застосунку ($10, $25 або $100) або обираєш «без ліміту». Коли його досягнуто, нові завдання зупиняються до наступного місяця (UTC). Щоб змінити ліміт, скасуй доступ і підключися знову. key_spend_cap_reached
Особистий чи командний
Якщо ти власник або керівник команди, застосунок можна підключити до команди. Тоді його запуски оплачуються з балансу команди.
Двоетапна перевірка
Якщо її ввімкнено, екран входу попросить код автентифікатора (або резервний код), перш ніж ти зможеш дозволити доступ.
Скасування доступу
У розділі Обліковий запис › Ключі API › Підключені застосунки перелічено кожен застосунок, у який ти входив, з обліковим записом і лімітом. Скасуй доступ — і застосунок одразу перестане працювати.
Збереження входу
Застосунки самі поновлюють свій доступ. Якщо застосунком не користуються 90 днів або ти його прибрав, він попросить увійти знову.
Ключі API для інструментів коду
Дай кожному інструментові власний ключ лише з потрібними завданнями й місячним лімітом витрат. Відкликай один, не зачіпаючи інших.
Керувати ключамиІнструменти
Після підключення твій асистент бачить ці інструменти (53). Інструменти переліку, цін і відстеження безкоштовні; платні показують ціну перед початком.
list_modelsМоделі за типом, із ціною для твоїх налаштуваньБезкоштовноget_modelОдна модель з усіма її параметрами (дозволені значення, діапазони, типові значення)Безкоштовноestimate_priceТочна ціна до будь-якого запускуБезкоштовноaccount_balanceБаланс і витрати цього ключа за місяцьБезкоштовноaccount_usageВитрати за днями й моделями за періодБезкоштовноgenerateЗображення, відео, аудіо чи 3D на будь-якій моделі (асинхронно, повертає id)Платноgenerate_image1–4 зображення, до 4K, з мініатюрами для переглядуПлатноgenerate_speechТекст у мовлення (MP3) обраним голосомПлатноgenerate_sfxЗвукові ефекти з тривалістю й безшовним лупомПлатноgenerate_musicМузичні треки з рівнем, тривалістю, стилем і текстомПлатноgenerate_3dФото чи промпт у 3D-модель (GLB); ремеш, риг або нова текстура для власних 3D-моделейПлатноlist_voicesГолоси для моделі мовлення, спершу твої власні клонованіБезкоштовноlist_voice_stylesГотові стилі мовлення; передай вказівку як extra.style_instructionsБезкоштовноget_generationСтатус, результати, повернення в разі невдачі — з очікуваннямБезкоштовноlist_generationsТвої нещодавні генерації з фільтром за статусомБезкоштовноcancel_generationСкасувати генерацію, яка ще не почаласяБезкоштовноupload_from_urlДодати публічне зображення чи відео як вхідні даніБезкоштовноupload_fileДодати файли, прикріплені в чаті (ChatGPT), як вхідні даніБезкоштовноcreate_upload_linkЗавантажити файл із комп’ютера (Codex, Claude Code) до 100 МББезкоштовноfcaai_toolsАктуальний список інструментів, зокрема доданих після твого підключенняБезкоштовноfcaai_callЗапустити будь-який поточний інструмент, навіть якщо твій застосунок його ще не показуєПлатноlist_templatesГотові рецепти та вхідні дані, які вони приймаютьБезкоштовноrun_templateЗапустити шаблон зі своїми значеннямиПлатноget_template_runСтатус запуску багатокрокового шаблонуБезкоштовноdecide_template_planЗатвердьте або змініть план кадрів для запуску кінематографічного шаблонуБезкоштовноcancel_template_runСкасувати запуск багатокрокового шаблонуБезкоштовноlist_flowsДошки Canvas, опубліковані як один рецепт, із вхідними даними й ціноюБезкоштовноrun_flowЗапустити Flow зі своїми значеннями; кожен крок виконується на нашому боціПлатноget_flow_runКроки й результати запуску FlowБезкоштовноcancel_flow_runСкасувати запуск FlowБезкоштовноsearch_community_flowsПошук серед Flow, якими поділилася спільнотаБезкоштовноcreate_timelineВід розкадровки до короткого фільму: попередні версії, схвалення, повна якість, безкоштовний монтажПлатноget_timelineСтатус таймлайну сценБезкоштовноpreview_timelineДешеві попередні версії сцен розкадровки перед повною якістюПлатноapprove_timelineСхвалити попередньо переглянуті сцениБезкоштовноfinalize_timelineСтворити схвалені сцени в повній якостіПлатноexport_timelineЗ’єднати сцени в один MP4 з голосом і музикоюБезкоштовноedit_videoОбрізати й з’єднати власні відео, додати звукову доріжкуБезкоштовноlist_style_kitsСтильові набори й бренд-кіти: палітра, шрифти, правилаБезкоштовноlist_elementsПерсонажі, товари, місця й матеріалиБезкоштовноread_planЗ плану поверху — список кімнат із вказаними площами, дверима й вікнамиПлатноfinish_panoramaПідготувати 360°-рендер до перегляду: 2:1, безшовний крайБезкоштовноlist_architecture_projectsТвої проєкти Architecture StudioБезкоштовноcreate_architecture_projectСтворити архітектурний проєктБезкоштовноadd_to_architecture_projectДодати зображення чи результат до проєктуБезкоштовноproduct_list_from_imageСписок товарів за меблями й оздобленням на рендеріПлатноadd_compliance_labelДодати до зображення позначку «ілюстративне зображення»Безкоштовноlist_compliance_labelsПозначки «ілюстративне зображення» у проєктіБезкоштовноlist_approvalsЗапити на схвалення від клієнтів на дошці та їхні варіантиБезкоштовноdecide_approvalСхвалити варіант або попросити про зміни з приміткоюБезкоштовноlist_farm_jobsЗавдання рендер-ферми 3ds Max: прогрес і вартістьБезкоштовноpause_farm_jobПризупинити завдання рендер-ферми, що виконуєтьсяБезкоштовноresume_farm_jobВідновити призупинене завдання рендер-фермиБезкоштовноНалаштування ключа API
Для інструментів, що підключаються з ключем. Радимо окремий ключ для кожного інструмента.
Область доступу
Ключ може виконувати лише обрані тобою завдання. Якщо нічого не обрано, дозволено всі види генерації: generations:image · video · audio · 3d · upscale · llm
Місячний ліміт витрат
Коли ліміт досягнуто, асистент зупиняється й отримує цю помилку. Ліміт скидається на початку кожного календарного місяця (UTC): key_spend_cap_reached
Частота й одночасність
Типово 120 запитів на хвилину й 2 завдання одночасно. Можна додати список дозволених IP і дату закінчення дії.
Безпечні вхідні дані
Адреси, які передає асистент, мають бути публічними посиланнями https; внутрішні мережі й приватні адреси відхиляються.
Ключ показується один раз і зберігається лише як хеш SHA-256.
Розв’язання проблем
Коди помилок з’являються в результаті інструмента, який бачить твій асистент. Ось що вони означають і що робити.
Просить увійти знову401 · invalid_token
Термін доступу застосунку минув, або доступ скасовано. Підключися знову: у Claude натисни Reconnect на конекторі, у Claude Code виконай /mcp, в інших застосунках прибери fcaai й додай його знову.
Досягнуто місячного лімітуkey_spend_cap_reached
Застосунок або ключ вичерпав місячний ліміт. Підвищ ліміт ключа в розділі Обліковий запис › Ключі API або прибери застосунок і підключи знову з вищим лімітом.
Бракує балансу402 · insufficient_balance
Поповни баланс і попроси асистента спробувати ще раз. Нічого не списано.
ПоповнитиМодель недоступнаmodel_unavailable
Модель зайнята або призупинена. Якщо є запасний маршрут, ми перемикаємося на нього автоматично; інакше спробуй трохи згодом або попроси іншу модель.
Налаштування проігнорованоignored_fields
Запуск відбувся, а в ignored_fields перелічено кожне налаштування, якого ця модель не приймає, з причиною. Попроси асистента перевірити через get_model, що приймає модель.
Значення відхиленоinvalid_<field> · invalid_arguments
Таке значення не дозволене для цієї моделі. У помилці перелічено дозволені значення, тож асистент може повторити з одним із них. Нічого не списано.
Інструменти fcaai не з’являються
Перевір, що адреса закінчується на /mcp. Потім онови: у ChatGPT — Refresh на сторінці Plugins; у Claude — увімкни fcaai в + › Connectors; у Cursor — увімкни його в Customize; у VS Code — Restart Server. Досі нічого? Прибери fcaai й додай його знову.
Забагато запитівrate_limited
Типово 120 запитів на хвилину на підключення, а деякі інструменти мають власний хвилинний ліміт. Зачекай хвилину й спробуй ще раз.
Заблоковано в робочій мережі
Застосункам на твоєму комп’ютері (Claude Code, Codex, Cursor, VS Code…) потрібен HTTPS-доступ до api.fcaai.ai, а вхід відкриває fcaai.ai у твоєму браузері. Попроси ІТ-відділ дозволити обидві адреси.
Запитання
Чи коштує MCP додатково?
Ні. Ти платиш лише за запущені генерації — за цінами API в доларах США. Перелік, розрахунок ціни й перевірка статусу безкоштовні.
Чи працює мій безлімітний план через MCP?
Ні. API, MCP-сервер і плагіни завжди використовують твій баланс. Безлімітне використання охоплює Studio, Canvas і шаблони на сайті та в застосунку.
Чи може асистент почати дороге завдання без запиту?
ChatGPT і Claude можуть питати тебе перед запуском інструмента, а сервер наказує асистентові називати ціну перед відео- та 4K-завданнями. Справжній запобіжник — місячний ліміт, який ти встановлюєш під час підключення (або ліміт витрат ключа): щойно його досягнуто, нові завдання не починаються.
Де зберігаються результати?
У твоїй бібліотеці fcaai, як і все, що ти створюєш у Studio. Асистент дає посилання, а Claude Code, Codex та інші термінальні інструменти можуть зберегти файл просто у твою теку.
Вхід чи ключ API: що обрати?
Входь, коли застосунок це пропонує: не треба копіювати ключ, ти обираєш обліковий запис і місячний ліміт, а прибрати застосунок можна одним кліком. Ключ API використовуй для скриптів, CI та середовищ, де ніхто не може ввійти через браузер.
Хто може користуватися MCP-сервером?
Будь-який обліковий запис fcaai — особистий чи командний. Запуски оплачуються з балансу цього облікового запису за цінами API, незалежно від плану.
Що буде, якщо запуск не вдасться?
Зарезервована сума повертається автоматично. Якщо звичний маршрут моделі не спрацьовує, ми повторюємо спробу запасним маршрутом за тією самою ціною.


