- 驗證方式
- 使用 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?
一種讓 AI 助理使用外部工具的開放標準。當你的助理無法自己完成某項工作時,它會呼叫已連接伺服器上合適的工具,並把結果帶回給你。fcaai 提供工具,你只要用說的就好。
適合用來做什麼?
不必切換分頁,直接在對話中創作。在重複、多步驟的工作上差異最明顯。
- 昂貴的工作會先詢問。 伺服器會要求助理在影片與 4K 工作前先說明價格。
- 每個模型、每項設定。 長寬比、長度、解析度與音訊等選項,都來自各模型自己的選項清單。
- 你的 Canvas 變成一項工具。 你發布的畫板只要一次呼叫就能作為流程執行。
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 方案中,擁有者可為所有人新增 fcaai,位置在 Organization settings › Connectors › Add › Custom › Web. 接著每位成員在 Customize › Connectors 中選擇「Connect」,並用自己的 fcaai 帳號登入。
連接完成後,fcaai 也能在 Claude 行動應用程式中使用;用同一個 Claude 帳號登入 Claude Code 時也能使用。
https://api.fcaai.ai/mcpfcaai 會列在「Your connectors」下,狀態為「Connected」。
使用 fcaai:列出圖片模型及其價格。
列出模型是免費的,所以這項測試不會花任何費用。
第一步
像向同事交代工作一樣跟你的助理說話。第一次記得提到 fcaai,助理才會選用正確的工具。
提示詞範例
用 fcaai 生成兩張 16:9 的圖片:藍調時刻,松林山脊上的一棟玻璃別墅。先告訴我價格。
用 fcaai 把我的客廳改成日式北歐(Japandi)風格,保留窗戶和格局: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。
在 fcaai 上生成一支 10 秒、1080p、有聲音的影片要多少錢?先不要執行。
我這個月在 fcaai 花了多少錢,花在哪些模型上?我的餘額是多少?
把你的圖片交給助理
fcaai 工具接受的是連結,不是檔案附件。以下任一方式都可以:
圖片、影片或音訊檔案的公開 https 連結(最大 50 MB)。助理會直接使用,或先將它複製到 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 天未使用,或你將它移除,它會要求你重新登入。
工具
連接後,你的助理會看到這 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 MB免費fcaai_tools即時工具清單,包括你連線後才新增的工具免費fcaai_call執行任何現有工具,即使你的應用程式尚未列出付費list_templates現成的配方及其所需的輸入免費run_template用你的值執行範本付費get_template_run多步驟範本執行的狀態免費decide_template_plan核准或改寫影片範本執行的鏡頭計畫免費cancel_template_run取消多步驟範本執行免費list_flows發布為單一配方的 Canvas 畫板,附上輸入與價格免費run_flow用你的值執行流程;每個步驟都在我們這端執行付費get_flow_run流程執行的步驟與輸出免費cancel_flow_run取消流程執行免費search_community_flows搜尋社群分享的流程免費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_jobs3ds Max 渲染農場工作:進度與費用免費pause_farm_job暫停執行中的渲染農場工作免費resume_farm_job繼續已暫停的渲染農場工作免費API 金鑰設定
適用於以金鑰連接的工具。建議每個工具各用一把金鑰。
權限範圍
金鑰只能執行你選擇的工作。若未選擇任何項目,則允許所有類型的生成: generations:image · video · audio · 3d · upscale · llm
每月支出上限
達到上限時,助理會停止並收到這個錯誤。上限會在每個日曆月開始時(UTC)重設: key_spend_cap_reached
頻率與並行數
預設每分鐘 120 個請求、同時 2 個工作。你也可以加入 IP 允許清單與到期日。
安全的輸入
助理傳入的位址必須是公開的 https 連結;內部網路與私人位址會被拒絕。
疑難排解
錯誤代碼會出現在助理看到的工具結果中。以下說明它們的意思和處理方式。
被要求重新登入401 · invalid_token
應用程式的存取權已過期或被移除。請重新連線:在 Claude 中,於連接器上選擇「重新連線」;在 Claude Code 中執行 /mcp;在其他地方則移除 fcaai 後重新新增。
已達每月上限key_spend_cap_reached
應用程式或金鑰已用完每月額度。請到「帳號 › API 金鑰」提高金鑰上限,或移除應用程式後以更高的上限重新連線。
模型無法使用model_unavailable
模型忙碌中或已暫停。若有備用路線,我們會自動切換;否則請稍後再試,或改用其他模型。
有設定被忽略ignored_fields
執行已照常進行,ignored_fields 會列出該模型不接受的每個設定及原因。請助理用 get_model 查看模型接受哪些設定。
有值被拒絕invalid_<field> · invalid_arguments
此值不適用於該模型。錯誤訊息會列出允許的值,助理可以改用其中一個重試。這次沒有收取任何費用。
沒有出現 fcaai 工具
確認位址以 /mcp 結尾。然後重新整理:在 ChatGPT 中,到「Plugins」頁面點選「Refresh」;在 Claude 中,於「+ › 連接器」開啟 fcaai;在 Cursor 中,於「Customize」將它開啟;在 VS Code 中,執行「Restart Server」。還是沒有?移除 fcaai 後重新新增。
請求過多rate_limited
預設每個連線每分鐘 120 個請求,部分工具另有自己的每分鐘上限。請等一分鐘後再試。
在公司網路上被封鎖
你電腦上的應用程式(Claude Code、Codex、Cursor、VS Code…)需要能以 HTTPS 存取 api.fcaai.ai,而登入時會在瀏覽器中開啟 fcaai.ai。請 IT 部門將兩者都設為允許。
問題
使用 MCP 需要額外付費嗎?
不需要。你只需為你執行的生成付費,以美元計的 API 價格計算。列出清單、報價與狀態查詢都免費。
我的無限方案可以透過 MCP 使用嗎?
不行。API、MCP 伺服器與外掛程式一律使用你的餘額。無限使用適用於網站與應用程式中的 Studio、Canvas 與範本。
助理會不會沒問過我就開始昂貴的工作?
ChatGPT 與 Claude 可以在工具執行前先詢問你,伺服器也會要求助理在影片與 4K 工作前先說明價格。真正的保障是你連線時設定的每月上限(或金鑰的支出上限):一旦達到上限,就不會再開始新的工作。
輸出儲存在哪裡?
在你的 fcaai 媒體庫中,就像你在 Studio 製作的所有作品一樣。助理會給你連結,而 Claude Code、Codex 等終端機工具還能把檔案直接存進你的資料夾。
登入還是 API 金鑰:該用哪一個?
應用程式提供登入時就用登入:不需要複製金鑰,你可以選擇帳號與每月上限,也能一鍵移除應用程式。腳本、CI 以及沒有人能透過瀏覽器登入的環境,則使用 API 金鑰。
誰可以使用 MCP 伺服器?
任何 fcaai 帳號,個人或團隊皆可。執行費用以 API 價格從該帳號的餘額扣除,不論你使用哪種方案。
執行失敗會怎樣?
預留的金額會自動退回。若某個模型的一般路徑失敗,我們會以相同價格改走備援路徑重試。


