Sari la conținut
RuleazăStreamable HTTP · OAuth 2.1

Documentație MCP

Spune doar ce vrei. Asistentul alege instrumentul potrivit, îți spune prețul și îți aduce rezultatul.

Adresa serveruluihttps://api.fcaai.ai/mcp
Autentificare
Conectare cu fcaai (OAuth) sau cheie API OAuth 2.1 (PKCE) · Bearer fcaai_live_…
Permisiune necesară
generations:write
Protocol
2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
Preț
Prețuri API · USD · rulările eșuate sunt rambursate

ChatGPT și Claude se conectează prin contul tău fcaai, fără nicio cheie de copiat. Uneltele de programare se pot conecta și ele sau pot folosi o cheie API. Cheile de test (fcaai_test_) se facturează ca cele live. Creează o cheie

Ce este MCP?

Un standard deschis care permite asistenților AI să folosească instrumente externe. Când asistentul nu poate face singur o sarcină, apelează instrumentul potrivit de pe un server conectat și îți aduce rezultatul. fcaai oferă instrumentele; tu doar vorbești.

1 · Tu
Scrii cererea
„Fă upscale acestei randări la 4K și spune-mi mai întâi cât costă.”
2 · Asistentul tău
Claude · ChatGPT · Codex · Cursor
Înțelege cererea și decide ce instrumente fcaai îi trebuie: estimate_price → generate
3 · Serverul MCP fcaai
Rulează modelul, returnează rezultatul
Același sold ca în Studio. O ofertă de preț e gratuită, iar un job eșuat se rambursează.
Imagine · upscaleVideoVoce · muzică3D

La ce e bun?

Creezi direct din conversație, fără să schimbi filele. Face cea mai mare diferență la munca repetitivă, în mai mulți pași.

  • Întreabă înainte de joburile scumpe. Serverul îi cere asistentului să spună prețul înainte de joburile video și 4K.
  • Fiecare model, fiecare setare. Opțiuni precum raportul de aspect, durata, rezoluția și audio vin din lista proprie a fiecărui model.
  • Canvas-ul tău devine un instrument. Planșele pe care le publici rulează ca Flow cu un singur apel.
Claudefcaai conectatExemplu de conversație
Fă upscale acestei randări la 4K, dar spune-mi mai întâi cât costă: 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
Un upscale 2× dă 3840×2160 pentru cam $0.008. Încep acum.
generatemodel: fca/upscale · image: /u/… · tier: 2xqueued
get_generationwait_seconds: 50succeeded
villa-blue-hour_4k.png
3840×2160 · fca/upscale · $0.008

Configurare pentru asistentul tău

Alege aplicația. Fiecare ghid a fost verificat cu documentația oficială a aplicației. ChatGPT și Claude se conectează prin contul fcaai; uneltele de programare se pot conecta și ele sau pot folosi o cheie API.

Claude · claude.ai, Desktop, mobilFuncționează · conectare cu fcaai

Claude se conectează prin contul tău fcaai, fără nicio cheie API de copiat. Conectorii personalizați funcționează pe planurile Free, Pro, Max, Team și Enterprise; pe Free poți adăuga unul.

  1. Deschide conectorii

    Pe claude.ai sau în aplicația desktop Claude, mergi la Customize › Connectors › Add custom connector
  2. Introdu adresa

    Nume fcaai · URL https://api.fcaai.ai/mcpDacă fereastra te întreabă cum se identifică Claude (client OAuth), alege Register automatically
  3. Conectare cu fcaai

    Se deschide ecranul fcaai. Alege contul (personal sau de echipă), setează o limită lunară și selectează Allow. Dacă ai verificarea în doi pași activă, introdu codul.
  4. Activează-l într-un chat

    În caseta de mesaj, deschide + › Connectors și activează fcaai. Claude te poate întreba înainte să ruleze un instrument: alege Allow once sau Always allow.

Pe Team sau Enterprise, un Owner adaugă fcaai pentru toată lumea în Organization settings › Connectors › Add › Custom › Web. Fiecare membru selectează apoi Connect în Customize › Connectors și se conectează cu propriul cont fcaai.

După conectare, fcaai funcționează și în aplicația mobilă Claude și în Claude Code, când te conectezi cu același cont Claude.

Adresa serverului
https://api.fcaai.ai/mcp
Când funcționează

fcaai apare în Your connectors ca Connected.

Testează-l
Folosește fcaai: listează modelele de imagine și prețurile lor.

Listarea modelelor e gratuită, așa că acest test nu costă nimic.

Primii pași

Vorbește cu asistentul cum i-ai da un brief unei persoane. Menționează fcaai prima dată, ca să ajungă la instrumentele potrivite.

Exemple de prompturi

Creează imaginiFolosește fcaai ca să faci două imagini 16:9 cu o vilă de sticlă pe o creastă cu pini, la ora albastră. Spune-mi mai întâi prețul.
estimate_pricegenerate_image
Editare cu o referințăRestilizează-mi livingul în stil japandi cu fcaai și păstrează ferestrele și compartimentarea: https://example.com/room.jpg
upload_from_urlgenerate_image
Imagine în videoFă un videoclip de 5 secunde care începe pe https://example.com/day.jpg și se termină pe https://example.com/night.jpg. Spune-mi prețul înainte să începi.
get_modelestimate_pricegenerate
UpscaleFă upscale ultimei mele randări fcaai la 4K.
list_generationsgenerate
Voice-overArată-mi vocile fcaai, apoi citește acest paragraf cu o voce calmă și caldă.
list_voicesgenerate_speech
MuzicăFă o piesă lo-fi instrumentală de 30 de secunde pentru un videoclip de produs.
generate_music
ȘabloaneCe șabloane fcaai transformă un plan într-o randare? Rulează-l pe cel mai bun pe https://example.com/plan.png.
list_templatesrun_template
Mai întâi prețulCât ar costa pe fcaai un videoclip de 10 secunde la 1080p cu sunet? Nu-l rula.
get_modelestimate_price
CheltuieliCât am cheltuit pe fcaai luna aceasta și pe ce modele? Care e soldul meu?
account_usageaccount_balance

Dă-i asistentului imaginea ta

Instrumentele fcaai primesc linkuri, nu atașamente. Oricare dintre acestea funcționează:

Lipește un link

Un link https public către o imagine, un videoclip sau un fișier audio (până la 50 MB). Asistentul îl folosește direct sau îl copiază mai întâi în fcaai cu upload_from_url

Folosește ceva creat în fcaai

Rezultatele au linkuri de tipul https://fcaai.ai/o/…. Sau spune doar „folosește ultima mea randare”, iar asistentul o găsește cu list_generations

Din terminal

Claude Code, Codex și Gemini CLI pot încărca un fișier local cu fcaai CLI și pot folosi linkul afișat:

Terminal
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg   # prints a link to pass to the assistant
Imaginile atașate într-un chat ChatGPT sau Claude nu ajung la fcaai. Asistentul le poate vedea, dar nu poate trimite fișierul unui instrument. Distribuie un link în schimb.

Linkurile trebuie să fie publice. Adresele din rețele private sau paginile care necesită conectare sunt refuzate.

Joburi lungi: video și 3D

Generările rulează în fundal. Asistentul așteaptă cu get_generation (până la 50 de secunde per verificare) și verifică din nou până când rezultatul e gata. Dacă chatul se încheie înainte, jobul se termină oricum și ajunge în bibliotecă. Întreabă mai târziu: „arată-mi cele mai noi generări fcaai”.

Unde ajung rezultatele

Fiecare rezultat se salvează în biblioteca fcaai, cu un link de descărcare. Asistenții din terminal pot salva fișierul și direct în folderul proiectului.

Conexiuni și cheltuieli

Tu alegi ce cont folosește o aplicație și cât poate cheltui și te poți răzgândi oricând.

O limită lunară pentru fiecare aplicație

Pe ecranul de conectare fcaai setezi o limită lunară pentru acea aplicație ($10, $25 sau $100) sau fără limită. Când e atinsă, joburile noi se opresc până luna viitoare (UTC). Ca s-o schimbi, revocă accesul și conectează-te din nou. key_spend_cap_reached

Personal sau echipă

Dacă deții sau administrezi o echipă, poți conecta aplicația la echipă. Rulările ei se plătesc atunci din soldul echipei.

Verificare în doi pași

Dacă e activă, ecranul de conectare îți cere codul din aplicația de autentificare (sau un cod de rezervă) înainte să permiți accesul.

Revocă accesul

Cont › Chei API › Aplicații conectate listează fiecare aplicație la care te-ai conectat, cu contul și limita ei. Revoci accesul și aplicația nu mai funcționează imediat.

Rămâi conectat

Aplicațiile își reînnoiesc singure accesul. Dacă o aplicație nu e folosită 90 de zile sau o elimini, îți cere să te conectezi din nou.

Chei API pentru uneltele de programare

Dă-i fiecărei unelte propria cheie, doar cu sarcinile de care are nevoie și cu un plafon lunar de cheltuieli. Revoci una fără să le atingi pe celelalte.

Gestionează cheile

Instrumente

După conectare, asistentul tău vede aceste 53 instrumente. Instrumentele de listare, prețuri și urmărire sunt gratuite; cele plătite își arată prețul înainte să pornească.

5 instrumente
list_modelsModele după tip, cu prețul pentru setările taleGratuit
get_modelUn model cu toate opțiunile pe care le acceptă (valori permise, intervale, valori implicite)Gratuit
estimate_pricePrețul exact înainte să ruleze cevaGratuit
account_balanceSoldul și cheltuielile acestei chei luna aceastaGratuit
account_usageCheltuieli pe zi și pe model pentru un interval de dateGratuit

Setările cheii API

Pentru instrumentele care se conectează cu o cheie. Recomandăm o cheie separată pentru fiecare instrument.

Permisiuni

O cheie poate face doar sarcinile alese de tine. Dacă nu alegi niciuna, e permis orice tip de generare: generations:image · video · audio · 3d · upscale · llm

Plafon lunar de cheltuieli

Când plafonul e atins, asistentul se oprește și primește această eroare. Plafonul se resetează la începutul fiecărei luni calendaristice (UTC): key_spend_cap_reached

Ritm și concurență

Implicit 120 de cereri pe minut și 2 joburi simultan. Poți adăuga o listă de IP-uri permise și o dată de expirare.

Intrări sigure

Adresele transmise de asistent trebuie să fie linkuri https publice; rețelele interne și adresele private sunt refuzate.

Cheie nouăExemplu de ecran al contului
Nume
Claude Code · laptop
Mod
Joburi permise
Creează o cheie

Cheia e afișată o singură dată și stocată doar ca hash SHA-256.

Depanare

Codurile de eroare apar în rezultatul instrumentului pe care îl vede asistentul. Iată ce înseamnă și ce poți face.

Ți se cere să te conectezi din nou401 · invalid_token

Accesul aplicației a expirat sau a fost revocat. Reconectează-te: în Claude selectează Reconnect pe conector, în Claude Code rulează /mcp, iar în rest elimină fcaai și adaugă-l din nou.

Limita lunară a fost atinsăkey_spend_cap_reached

Aplicația sau cheia și-a epuizat limita lunară. Mărește plafonul cheii în Cont › Chei API sau elimină aplicația și conectează-te din nou cu o limită mai mare.

Sold insuficient402 · insufficient_balance

Alimentează-ți soldul și cere-i asistentului să încerce din nou. Nu s-a perceput nimic.

Alimentează
Model indisponibilmodel_unavailable

Modelul este ocupat sau pus pe pauză. Când există o rută de rezervă, trecem automat pe ea; altfel încearcă din nou în scurt timp sau cere alt model.

O setare a fost ignoratăignored_fields

Rularea a continuat, iar ignored_fields listează fiecare setare pe care modelul nu o acceptă, cu motivul. Cere-i asistentului să verifice cu get_model ce acceptă modelul.

O valoare a fost respinsăinvalid_<field> · invalid_arguments

Valoarea nu este permisă pentru acel model. Eroarea listează valorile permise, ca asistentul să reîncerce cu una dintre ele. Nu s-a perceput nimic.

Nu apare niciun instrument fcaai

Verifică dacă adresa se termină cu /mcp. Apoi reîmprospătează: în ChatGPT, Refresh pe pagina Plugins; în Claude, activează fcaai la + › Connectors; în Cursor, activează-l în Customize; în VS Code, Restart Server. Tot nimic? Elimină fcaai și adaugă-l din nou.

Prea multe cererirate_limited

Implicit 120 de cereri pe minut per conexiune, iar unele instrumente au propria limită pe minut. Așteaptă un minut și încearcă din nou.

Blocat într-o rețea de serviciu

Aplicațiile de pe computer (Claude Code, Codex, Cursor, VS Code…) au nevoie de acces HTTPS la api.fcaai.ai, iar conectarea deschide fcaai.ai în browser. Cere departamentului IT să le permită pe amândouă.

Întrebări

Folosirea MCP costă în plus?

Nu. Plătești doar generările pe care le rulezi, la prețuri API în dolari americani. Listările, ofertele de preț și verificările de stare sunt gratuite.

Funcționează planul meu nelimitat prin MCP?

Nu. API-ul, serverul MCP și pluginurile folosesc întotdeauna soldul tău. Utilizarea nelimitată acoperă Studio, Canvas și șabloanele de pe site și din aplicație.

Poate asistentul să pornească un job scump fără să întrebe?

ChatGPT și Claude te pot întreba înainte să ruleze un instrument, iar serverul îi cere asistentului să spună prețul înainte de joburile video și 4K. Protecția ta reală este limita lunară pe care o setezi la conectare (sau plafonul de cheltuieli al cheii): odată atinsă, nu mai pornește niciun job nou.

Unde sunt stocate rezultatele?

În biblioteca ta fcaai, ca tot ce creezi în Studio. Asistentul îți dă linkul, iar Claude Code, Codex și alte unelte de terminal pot salva fișierul direct în folderul tău.

Conectare sau cheie API: pe care s-o folosesc?

Conectează-te când aplicația îți oferă opțiunea: nu ai nicio cheie de copiat, alegi contul și o limită lunară și poți elimina aplicația cu un clic. Folosește o cheie API pentru scripturi, CI și configurații unde nimeni nu se poate conecta printr-un browser.

Cine poate folosi serverul MCP?

Orice cont fcaai, personal sau de echipă. Rulările se plătesc din soldul acelui cont la prețuri API, indiferent de plan.

Ce se întâmplă dacă o rulare eșuează?

Suma rezervată revine automat. Dacă ruta obișnuită a unui model eșuează, reîncercăm pe o rută de rezervă la același preț.