Lumaktaw sa nilalaman
TumatakboStreamable HTTP · OAuth 2.1

Dokumentasyon ng MCP

Sabihin lang ang gusto mo. Pipiliin ng assistant mo ang tamang tool, sasabihin ang presyo at ibabalik ang resulta.

Address ng serverhttps://api.fcaai.ai/mcp
Authentication
Mag-sign in gamit ang fcaai (OAuth) o API key OAuth 2.1 (PKCE) · Bearer fcaai_live_…
Kailangang scope
generations:write
Protocol
2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
Presyo
Presyong API · USD · ibinabalik ang bayad sa pumalyang run

Kumokonekta ang ChatGPT at Claude sa pag-sign in gamit ang fcaai account mo, walang key na kokopyahin. Puwede ring mag-sign in ang mga code tool, o gumamit ng API key. Sinisingil ang mga test key (fcaai_test_) gaya ng mga live key. Gumawa ng key

Ano ang MCP?

Isang open standard na nagpapahintulot sa mga AI assistant na gumamit ng mga panlabas na tool. Kapag hindi kayang gawin ng assistant mo ang isang trabaho nang mag-isa, tinatawag nito ang tamang tool sa nakakonektang server at ibinabalik sa iyo ang resulta. Ang fcaai ang nagbibigay ng mga tool; makipag-usap ka lang.

1 · Ikaw
Isulat ang request mo
“I-upscale ang render na ito sa 4K, at sabihin mo muna kung magkano.”
2 · Ang assistant mo
Claude · ChatGPT · Codex · Cursor
Inuunawa ang request at pinagpapasyahan kung aling fcaai tool ang kailangan: estimate_price → generate
3 · fcaai MCP server
Pinapatakbo ang model, ibinabalik ang resulta
Iisang balanse sa Studio. Libre ang quote, at ibinabalik ang bayad sa pumalyang job.
Larawan · upscaleVideoBoses · musika3D

Para saan ito maganda?

Gumawa mula sa loob ng usapan nang hindi lumilipat ng tab. Pinakamalaki ang naitutulong nito sa paulit-ulit at maraming hakbang na trabaho.

  • Nagtatanong muna bago ang mamahaling job. Sinasabihan ng server ang assistant na sabihin muna ang presyo bago ang mga video at 4K na job.
  • Bawat model, bawat setting. Galing sa sariling listahan ng bawat model ang mga opsyon gaya ng aspect ratio, haba, resolution at audio.
  • Nagiging tool ang Canvas mo. Tumatakbo bilang Flow ang mga board na pina-publish mo, sa iisang call lang.
Claudenakakonekta ang fcaaiHalimbawang usapan
I-upscale ang render na ito sa 4K, pero sabihin mo muna kung magkano: studio.example.com/villa-blue-hour.jpg
upload_from_urlurl: …/villa-blue-hour.jpg/u/…
estimate_pricemodel: fca/upscale · tier: 2x · source 1920×1080$0.008
Ang 2× na upscale ay magbibigay ng 3840×2160 sa halagang mga $0.008. Sinisimulan na.
generatemodel: fca/upscale · image: /u/… · tier: 2xqueued
get_generationwait_seconds: 50succeeded
villa-blue-hour_4k.png
3840×2160 · fca/upscale · $0.008

Setup para sa assistant mo

Piliin ang app mo. Sinuri ang bawat gabay batay sa opisyal na dokumentasyon ng app na iyon. Nagsa-sign in ang ChatGPT at Claude gamit ang fcaai account mo; puwede ring mag-sign in ang mga code tool, o gumamit ng API key.

Claude · claude.ai, Desktop, mobileGumagana · mag-sign in gamit ang fcaai

Kumokonekta ang Claude gamit ang fcaai account mo, walang API key na kokopyahin. Gumagana ang custom connectors sa Free, Pro, Max, Team at Enterprise na plan; sa Free, puwede kang magdagdag ng isa.

  1. Buksan ang mga connector mo

    Sa claude.ai o sa Claude desktop app, pumunta sa Customize › Connectors › Add custom connector
  2. Ilagay ang address

    Pangalan fcaai · URL https://api.fcaai.ai/mcpKung itanong ng dialog kung paano nagpapakilala ang Claude (OAuth client), piliin ang Register automatically
  3. Mag-sign in gamit ang fcaai

    Magbubukas ang screen ng fcaai. Piliin ang account (personal o team), magtakda ng buwanang limit at piliin ang Payagan. Kung naka-on ang two-step verification, ilagay ang code mo.
  4. I-on ito sa isang chat

    Sa message box, buksan ang + › Connectors at i-on ang fcaai. Puwedeng magtanong ang Claude bago tumakbo ang isang tool: piliin ang Allow once o Always allow.

Sa Team o Enterprise, idinadagdag ng isang Owner ang fcaai para sa lahat sa Organization settings › Connectors › Add › Custom › Web. Pagkatapos, pipiliin ng bawat miyembro ang Connect sa Customize › Connectors at magsa-sign in gamit ang sarili niyang fcaai account.

Kapag nakakonekta na, gumagana rin ang fcaai sa Claude mobile app, at sa Claude Code kapag nag-sign in ka gamit ang parehong Claude account.

Address ng server
https://api.fcaai.ai/mcp
Kapag gumagana na

Nakalista ang fcaai sa ilalim ng Your connectors bilang Connected.

Subukan
Gamitin ang fcaai: ilista ang mga model ng larawan at ang presyo nila.

Libre ang paglista ng mga model, kaya walang gastos ang test na ito.

Mga unang hakbang

Kausapin ang assistant mo na parang nagbibigay ka ng brief sa isang tao. Banggitin ang fcaai sa unang beses para gamitin nito ang tamang mga tool.

Mga halimbawang prompt

Gumawa ng mga larawanGamitin ang fcaai para gumawa ng dalawang 16:9 na larawan ng isang glass villa sa pine ridge sa blue hour. Sabihin mo muna ang presyo.
estimate_pricegenerate_image
Mag-edit gamit ang referenceI-restyle ang sala ko bilang Japandi gamit ang fcaai at panatilihin ang mga bintana at ang layout: https://example.com/room.jpg
upload_from_urlgenerate_image
Larawan papuntang videoGumawa ng 5-segundong video na nagsisimula sa https://example.com/day.jpg at nagtatapos sa https://example.com/night.jpg. Sabihin muna ang presyo bago ka magsimula.
get_modelestimate_pricegenerate
UpscaleI-upscale ang huli kong fcaai render sa 4K.
list_generationsgenerate
Voice-overIpakita ang mga boses sa fcaai, saka basahin ang talatang ito sa kalmado at mainit na boses.
list_voicesgenerate_speech
MusikaGumawa ng 30-segundong instrumental na lo-fi track para sa isang product video.
generate_music
Mga TemplateAling mga fcaai template ang ginagawang render ang floor plan? Patakbuhin ang pinakamahusay sa https://example.com/plan.png.
list_templatesrun_template
Presyo munaMagkano ang 10-segundong 1080p na video na may tunog sa fcaai? Huwag mo munang patakbuhin.
get_modelestimate_price
GastosMagkano na ang nagastos ko sa fcaai ngayong buwan, at sa aling mga model? Magkano ang balanse ko?
account_usageaccount_balance

Ibigay sa assistant ang larawan mo

Link ang tinatanggap ng mga fcaai tool, hindi file attachment. Gagana ang alinman dito:

Mag-paste ng link

Isang pampublikong https link ng larawan, video o audio file (hanggang 50 MB). Direkta itong ginagamit ng assistant, o kinokopya muna sa fcaai gamit ang upload_from_url

Gamitin ang ginawa mo sa fcaai

May mga link ang mga resulta gaya ng https://fcaai.ai/o/…. O sabihin lang na “gamitin ang huli kong render”, at hahanapin ito ng assistant gamit ang list_generations

Mula sa terminal

Makakapag-upload ng local na file ang Claude Code, Codex at Gemini CLI gamit ang fcaai CLI at magagamit ang link na ipi-print nito:

Terminal
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg   # prints a link to pass to the assistant
Hindi ipinapasa sa fcaai ang mga larawang ina-attach mo sa chat sa ChatGPT o Claude. Nakikita ito ng assistant, pero hindi nito maibibigay ang file sa isang tool. Magbahagi na lang ng link.

Kailangang pampubliko ang mga link. Tinatanggihan ang mga address sa pribadong network, o mga page na nasa likod ng sign-in.

Mahahabang job: video at 3D

Tumatakbo sa background ang mga generation. Naghihintay ang assistant gamit ang get_generation (hanggang 50 segundo bawat check) at sumusuri ulit hanggang handa na ang resulta. Kung matapos muna ang chat, matatapos pa rin ang job at mapupunta sa library mo. Itanong mamaya: “ipakita ang mga pinakabago kong fcaai generation”.

Saan napupunta ang mga resulta

Naka-save ang bawat resulta sa fcaai library mo na may download link. Puwede ring direktang i-save ng mga terminal assistant ang file sa folder ng project mo.

Mga koneksyon at gastos

Ikaw ang pipili kung aling account ang gagamitin ng app at magkano ang puwede nitong gastusin, at puwede kang magbago ng isip anumang oras.

Buwanang limit bawat app

Sa sign-in screen ng fcaai, magtatakda ka ng buwanang limit para sa app na iyon ($10, $25 o $100) o walang limit. Kapag naabot ito, hihinto ang mga bagong job hanggang sa susunod na buwan (UTC). Para palitan ito, alisin ang access at kumonekta ulit. key_spend_cap_reached

Personal o team

Kung may-ari o namamahala ka ng team, puwede mong ikonekta ang app sa team. Sa team balance na kukunin ang bayad ng mga run nito.

Two-step verification

Kung naka-on ito, hihingin ng sign-in screen ang code mula sa authenticator mo (o backup code) bago mo mapayagan ang access.

Alisin ang access

Nakalista sa Account › Mga API key › Mga nakakonektang app ang bawat app na pinag-sign in-an mo, kasama ang account at limit nito. Alisin ang access at agad na hihinto ang app.

Pananatiling naka-sign in

Kusang nire-renew ng mga app ang access nila. Kung hindi nagamit ang app nang 90 araw, o inalis mo ito, hihingin nitong mag-sign in ka ulit.

Mga API key para sa mga code tool

Bigyan ang bawat tool ng sariling key na may mga job lang na kailangan nito at buwanang cap sa gastos. Puwedeng i-revoke ang isa nang hindi nagagalaw ang iba.

Pamahalaan ang mga key

Mga Tool

Kapag nakakonekta na, makikita ng assistant mo ang 53 tool na ito. Libre ang mga tool para sa paglista, presyo at pagsubaybay; ipinapakita ng mga bayad na tool ang presyo bago sila magsimula.

5 tool
list_modelsMga model ayon sa uri, may presyo para sa mga setting moLibre
get_modelIsang model kasama ang bawat opsyong tinatanggap nito (mga pinapayagang value, saklaw, default)Libre
estimate_priceEksaktong presyo bago tumakbo ang anumanLibre
account_balanceBalanse at gastos ng key na ito ngayong buwanLibre
account_usageGastos kada araw at model sa isang saklaw ng petsaLibre

Mga setting ng API key

Para sa mga tool na kumokonekta gamit ang key. Inirerekomenda namin ang hiwalay na key para sa bawat tool.

Scope

Ang mga job lang na pinili mo ang magagawa ng key. Kung wala kang pinili, pinapayagan ang lahat ng uri ng generation: generations:image · video · audio · 3d · upscale · llm

Buwanang cap sa gastos

Kapag naabot ang cap, hihinto ang assistant at matatanggap nito ang error na ito. Nare-reset ang cap sa simula ng bawat buwan sa kalendaryo (UTC): key_spend_cap_reached

Rate at concurrency

Bilang default, 120 request kada minuto at 2 job nang sabay. Puwede kang magdagdag ng IP allow list at petsa ng pag-expire.

Ligtas na input

Kailangang pampublikong https link ang mga address na ipinapasa ng assistant; tinatanggihan ang mga internal network at pribadong address.

Bagong keyHalimbawa ng account screen
Pangalan
Claude Code · laptop
Mode
Pinapayagang job
Gumawa ng key

Isang beses lang ipinapakita ang key at naka-store lang ito bilang SHA-256 hash.

Pag-troubleshoot

Lumalabas ang mga error code sa tool result na nakikita ng assistant mo. Narito ang ibig sabihin nila at ang dapat gawin.

Pinag-sign in ulit401 · invalid_token

Nag-expire o inalis ang access ng app. Kumonekta ulit: sa Claude, piliin ang Reconnect sa connector; sa Claude Code, patakbuhin ang /mcp; sa iba pa, alisin ang fcaai at idagdag ulit.

Naabot ang buwanang limitkey_spend_cap_reached

Naubos ng app o key ang buwanang limit nito. Taasan ang cap ng key sa Account › Mga API key, o alisin ang app at kumonekta ulit na may mas mataas na limit.

Kulang ang balanse402 · insufficient_balance

Mag-top up ng balanse at hilingin sa assistant na subukan ulit. Walang siningil.

Mag-top up
Hindi available ang modelmodel_unavailable

Abala o naka-pause ang model. Kapag may backup na ruta, awtomatiko kaming lilipat doon; kung wala, subukan ulit maya-maya o humingi ng ibang model.

May setting na hindi pinansinignored_fields

Tumuloy ang run, at nakalista sa ignored_fields ang bawat setting na hindi tinatanggap ng model na iyon, kasama ang dahilan. Hilingin sa assistant na tingnan ang get_model para malaman kung ano ang tinatanggap ng model.

May value na tinanggihaninvalid_<field> · invalid_arguments

Hindi pinapayagan ang value para sa model na iyon. Nakalista sa error ang mga pinapayagang value, kaya makakaulit ang assistant gamit ang isa sa mga iyon. Walang siningil.

Walang lumalabas na fcaai tool

Tiyaking nagtatapos sa /mcp ang address. Saka i-refresh: sa ChatGPT, Refresh sa Plugins page; sa Claude, i-on ang fcaai sa + › Connectors; sa Cursor, i-on ito sa Customize; sa VS Code, Restart Server. Wala pa rin? Alisin ang fcaai at idagdag ulit.

Masyadong maraming requestrate_limited

Bilang default, 120 request kada minuto sa bawat koneksyon, at may sariling limit kada minuto ang ilang tool. Maghintay ng isang minuto at subukan ulit.

Naka-block sa network ng trabaho

Kailangan ng mga app sa computer mo (Claude Code, Codex, Cursor, VS Code…) ng HTTPS access sa api.fcaai.ai, at binubuksan ng sign-in ang fcaai.ai sa browser mo. Hilingin sa IT na payagan ang dalawa.

Mga Tanong

May dagdag bang bayad ang paggamit ng MCP?

Wala. Ang mga generation lang na pinapatakbo mo ang binabayaran mo, sa presyong API sa US dollars. Libre ang paglilista, quote ng presyo at pag-check ng status.

Gumagana ba ang unlimited plan ko sa MCP?

Hindi. Laging balanse mo ang ginagamit ng API, MCP server at mga plugin. Saklaw ng unlimited na paggamit ang Studio, Canvas at mga template sa website at sa app.

Makakapagsimula ba ang assistant ng mahal na job nang hindi nagtatanong?

Puwede kang tanungin ng ChatGPT at Claude bago tumakbo ang isang tool, at sinasabihan ng server ang assistant na banggitin ang presyo bago ang mga job sa video at 4K. Ang tunay mong proteksyon ay ang buwanang limit na itinakda mo nang kumonekta ka (o ang limit sa gastos ng key): kapag naabot ito, walang bagong job na magsisimula.

Saan iniimbak ang mga output?

Sa fcaai library mo, gaya ng lahat ng ginagawa mo sa Studio. Ibinibigay sa iyo ng assistant ang link, at kayang i-save nang diretso sa folder mo ng Claude Code, Codex at iba pang terminal tool ang file.

Sign-in o API key: alin ang dapat kong gamitin?

Mag-sign in kapag inaalok ito ng app mo: walang key na kokopyahin, pipiliin mo ang account at buwanang limit, at maaalis mo ang app sa isang click. Gumamit ng API key para sa mga script, CI at setup kung saan walang makakapag-sign in sa browser.

Sino ang puwedeng gumamit ng MCP server?

Anumang fcaai account, personal man o team. Binabayaran ang mga run mula sa balanse ng account na iyon sa presyong API, anuman ang plan mo.

Ano ang mangyayari kapag pumalya ang run?

Awtomatikong bumabalik ang inireserbang halaga. Kapag pumalya ang karaniwang ruta ng model, sinusubukan namin ulit sa backup na ruta sa parehong presyo.