Langkau ke kandungan
Sedang berjalanStreamable HTTP · OAuth 2.1

Dokumentasi MCP

Nyatakan sahaja apa yang anda mahu. Pembantu anda memilih alat yang betul, memberitahu anda harganya dan membawa pulang hasilnya.

Alamat pelayanhttps://api.fcaai.ai/mcp
Pengesahan
Log masuk dengan fcaai (OAuth) atau kunci API OAuth 2.1 (PKCE) · Bearer fcaai_live_…
Skop diperlukan
generations:write
Protokol
2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
Harga
Harga API · USD · larian gagal dibayar balik

ChatGPT dan Claude bersambung dengan log masuk akaun fcaai anda, tanpa kunci untuk disalin. Alat kod juga boleh log masuk, atau menggunakan kunci API. Kunci ujian (fcaai_test_) dibilkan seperti kunci langsung. Cipta kunci

Apakah itu MCP?

Piawaian terbuka yang membolehkan pembantu AI menggunakan alat luar. Apabila pembantu anda tidak dapat melakukan sesuatu kerja sendiri, ia memanggil alat yang betul pada pelayan yang disambungkan dan membawa hasilnya kepada anda. fcaai menyediakan alat; anda hanya bercakap.

1 · Anda
Tulis permintaan anda
“Besarkan render ini ke 4K, dan beritahu saya kosnya dahulu.”
2 · Pembantu anda
Claude · ChatGPT · Codex · Cursor
Memahami permintaan dan menentukan alat fcaai yang diperlukannya: estimate_price → generate
3 · Pelayan MCP fcaai
Menjalankan model, memulangkan hasil
Baki yang sama seperti Studio. Sebut harga adalah percuma, dan tugas yang gagal dibayar balik.
Imej · pembesaranVideoSuara · muzik3D

Apa kegunaannya?

Cipta dari dalam perbualan tanpa bertukar tab. Ia memberi perbezaan paling besar pada kerja berulang dan berbilang langkah.

  • Bertanya sebelum tugas mahal. Pelayan memberitahu pembantu supaya menyatakan harga sebelum tugas video dan 4K.
  • Setiap model, setiap tetapan. Pilihan seperti nisbah bidang, tempoh, resolusi dan audio datang daripada senarai setiap model itu sendiri.
  • Canvas anda menjadi alat. Papan yang anda terbitkan berjalan sebagai Flow dengan satu panggilan.
Claudefcaai disambungkanContoh perbualan
Besarkan render ini ke 4K, tetapi beritahu saya kosnya dahulu: 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
Pembesaran 2× memberi 3840×2160 pada kira-kira $0.008. Bermula sekarang.
generatemodel: fca/upscale · image: /u/… · tier: 2xqueued
get_generationwait_seconds: 50succeeded
villa-blue-hour_4k.png
3840×2160 · fca/upscale · $0.008

Persediaan untuk pembantu anda

Pilih aplikasi anda. Setiap panduan disemak berdasarkan dokumentasi rasmi aplikasi itu. ChatGPT dan Claude log masuk dengan akaun fcaai anda; alat kod juga boleh log masuk, atau menggunakan kunci API.

Claude · claude.ai, Desktop, mudah alihBerfungsi · log masuk dengan fcaai

Claude bersambung dengan akaun fcaai anda, tanpa kunci API untuk disalin. Penyambung tersuai berfungsi pada pelan Free, Pro, Max, Team dan Enterprise; pada Free anda boleh menambah satu.

  1. Buka penyambung anda

    Di claude.ai atau dalam aplikasi desktop Claude, pergi ke Customize › Connectors › Add custom connector
  2. Masukkan alamat

    Nama fcaai · URL https://api.fcaai.ai/mcpJika dialog bertanya cara Claude mengenal pasti dirinya (klien OAuth), pilih Register automatically
  3. Log masuk dengan fcaai

    Skrin fcaai dibuka. Pilih akaun (peribadi atau pasukan), tetapkan had bulanan dan pilih Benarkan. Jika pengesahan dua langkah dihidupkan, masukkan kod anda.
  4. Hidupkan dalam sembang

    Dalam kotak mesej, buka + › Connectors dan hidupkan fcaai. Claude boleh bertanya sebelum alat dijalankan: pilih Allow once atau Always allow.

Pada Team atau Enterprise, seorang Owner menambah fcaai untuk semua orang di Organization settings › Connectors › Add › Custom › Web. Setiap ahli kemudian memilih Connect dalam Customize › Connectors dan log masuk dengan akaun fcaai masing-masing.

Setelah disambungkan, fcaai juga berfungsi dalam aplikasi mudah alih Claude, dan dalam Claude Code apabila anda log masuk dengan akaun Claude yang sama.

Alamat pelayan
https://api.fcaai.ai/mcp
Apabila ia berfungsi

fcaai disenaraikan di bawah Your connectors sebagai Connected.

Uji
Gunakan fcaai: senaraikan model imej dan harganya.

Menyenaraikan model adalah percuma, jadi ujian ini tidak dikenakan apa-apa kos.

Langkah pertama

Bercakap dengan pembantu anda seperti anda memberi taklimat kepada seseorang. Sebut fcaai pada kali pertama, supaya ia mencapai alat yang betul.

Contoh prompt

Cipta imejGunakan fcaai untuk membuat dua imej 16:9 sebuah vila kaca di atas rabung pokok pain pada waktu senja biru. Beritahu harganya dahulu.
estimate_pricegenerate_image
Sunting dengan rujukanGayakan semula ruang tamu saya kepada Japandi dengan fcaai dan kekalkan tingkap serta susun aturnya: https://example.com/room.jpg
upload_from_urlgenerate_image
Imej ke videoBuat video 5 saat yang bermula pada https://example.com/day.jpg dan berakhir pada https://example.com/night.jpg. Beri sebut harga sebelum mula.
get_modelestimate_pricegenerate
BesarkanBesarkan render fcaai terakhir saya kepada 4K.
list_generationsgenerate
Suara latarTunjukkan suara fcaai, kemudian baca perenggan ini dengan suara yang tenang dan mesra.
list_voicesgenerate_speech
MuzikBuat runut lo-fi instrumental 30 saat untuk video produk.
generate_music
TemplatTemplat fcaai mana yang menukar pelan lantai menjadi render? Jalankan yang terbaik pada https://example.com/plan.png.
list_templatesrun_template
Harga dahuluBerapakah kos video 1080p 10 saat dengan bunyi di fcaai? Jangan jalankan.
get_modelestimate_price
PerbelanjaanBerapa banyak yang telah saya belanjakan di fcaai bulan ini, dan untuk model apa? Berapa baki saya?
account_usageaccount_balance

Beri pembantu imej anda

Alat fcaai menerima pautan, bukan lampiran fail. Mana-mana satu daripada ini boleh:

Tampal pautan

Pautan https awam ke fail imej, video atau audio (hingga 50 MB). Pembantu menggunakannya terus, atau menyalinnya ke fcaai dahulu dengan upload_from_url

Gunakan sesuatu yang anda hasilkan di fcaai

Hasil mempunyai pautan seperti https://fcaai.ai/o/…. Atau sebut sahaja “guna render terakhir saya”, dan pembantu mencarinya dengan list_generations

Daripada terminal

Claude Code, Codex dan Gemini CLI boleh memuat naik fail tempatan dengan CLI fcaai dan menggunakan pautan yang dicetaknya:

Terminal
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg   # prints a link to pass to the assistant
Imej yang anda lampirkan dalam sembang ChatGPT atau Claude tidak dihantar ke fcaai. Pembantu boleh melihatnya, tetapi tidak boleh menyerahkan fail itu kepada alat. Kongsi pautan sebagai ganti.

Pautan mestilah awam. Alamat pada rangkaian peribadi, atau halaman yang memerlukan log masuk, ditolak.

Tugas panjang: video dan 3D

Janaan berjalan di latar belakang. Pembantu menunggu dengan get_generation (hingga 50 saat setiap semakan) dan menyemak semula sehingga hasil sedia. Jika sembang tamat dahulu, tugas tetap selesai dan masuk ke pustaka anda. Tanya kemudian: “tunjukkan janaan fcaai terbaharu saya”.

Ke mana hasil pergi

Setiap hasil disimpan dalam pustaka fcaai anda dengan pautan muat turun. Pembantu terminal juga boleh menyimpan fail terus ke dalam folder projek anda.

Sambungan dan perbelanjaan

Anda memilih akaun yang digunakan aplikasi dan jumlah yang boleh dibelanjakannya, dan anda boleh mengubah fikiran pada bila-bila masa.

Had bulanan bagi setiap aplikasi

Pada skrin log masuk fcaai, anda menetapkan had bulanan untuk aplikasi itu ($10, $25 atau $100) atau tiada had. Apabila ia dicapai, tugas baharu berhenti hingga bulan berikutnya (UTC). Untuk menukarnya, buang akses dan sambung semula. key_spend_cap_reached

Peribadi atau pasukan

Jika anda memiliki atau mengurus pasukan, anda boleh menyambungkan aplikasi ke pasukan itu. Lariannya kemudian dibayar daripada baki pasukan.

Pengesahan dua langkah

Jika ia dihidupkan, skrin log masuk meminta kod pengesah anda (atau kod sandaran) sebelum anda boleh membenarkan akses.

Buang akses

Akaun › Kunci API › Aplikasi tersambung menyenaraikan setiap aplikasi yang anda log masuk, bersama akaun dan hadnya. Buang akses dan aplikasi berhenti berfungsi serta-merta.

Kekal log masuk

Aplikasi memperbaharui akses dengan sendirinya. Jika aplikasi tidak digunakan selama 90 hari, atau anda membuangnya, ia meminta anda log masuk semula.

Kunci API untuk alat kod

Beri setiap alat kuncinya sendiri dengan hanya kerja yang diperlukannya dan had belanja bulanan. Batalkan satu tanpa menjejaskan yang lain.

Urus kunci

Alat

Setelah disambungkan, pembantu anda melihat 53 alat ini. Alat penyenaraian, harga dan penjejakan adalah percuma; alat berbayar memaparkan harga sebelum bermula.

5 alat
list_modelsModel mengikut jenis, dengan harga untuk tetapan andaPercuma
get_modelSatu model dengan setiap pilihan yang diterimanya (nilai dibenarkan, julat, lalai)Percuma
estimate_priceHarga tepat sebelum apa-apa dijalankanPercuma
account_balanceBaki dan perbelanjaan kunci ini bulan iniPercuma
account_usagePerbelanjaan setiap hari dan model bagi satu julat tarikhPercuma

Tetapan kunci API

Untuk alat yang bersambung dengan kunci. Kami mengesyorkan kunci berasingan bagi setiap alat.

Skop

Kunci hanya boleh melakukan kerja yang anda pilih. Jika tiada yang dipilih, setiap jenis janaan dibenarkan: generations:image · video · audio · 3d · upscale · llm

Had belanja bulanan

Apabila had dicapai, pembantu berhenti dan menerima ralat ini. Had ditetapkan semula pada permulaan setiap bulan kalendar (UTC): key_spend_cap_reached

Kadar dan keserentakan

Secara lalai 120 permintaan seminit dan 2 tugas serentak. Anda boleh menambah senarai IP dibenarkan dan tarikh luput.

Input selamat

Alamat yang dihantar pembantu mestilah pautan https awam; rangkaian dalaman dan alamat peribadi ditolak.

Kunci baharuContoh skrin akaun
Nama
Claude Code · komputer riba
Mod
Kerja dibenarkan
Cipta kunci

Kunci dipaparkan sekali dan disimpan hanya sebagai cincangan SHA-256.

Penyelesaian masalah

Kod ralat muncul dalam hasil alat yang dilihat pembantu anda. Berikut maksudnya dan apa yang perlu dilakukan.

Diminta log masuk semula401 · invalid_token

Akses aplikasi telah tamat tempoh atau dibuang. Sambung semula: dalam Claude pilih Reconnect pada penyambung, dalam Claude Code jalankan /mcp, di tempat lain buang fcaai dan tambah semula.

Had bulanan dicapaikey_spend_cap_reached

Aplikasi atau kunci telah menghabiskan had bulanannya. Naikkan had kunci di Akaun › Kunci API, atau buang aplikasi dan sambung semula dengan had yang lebih tinggi.

Baki tidak mencukupi402 · insufficient_balance

Tambah nilai baki anda dan minta pembantu mencuba lagi. Tiada caj dikenakan.

Tambah nilai
Model tidak tersediamodel_unavailable

Model sedang sibuk atau dijeda. Apabila laluan sandaran wujud, kami bertukar kepadanya secara automatik; jika tidak, cuba lagi sebentar lagi atau minta model lain.

Satu tetapan diabaikanignored_fields

Larian diteruskan, dan ignored_fields menyenaraikan setiap tetapan yang tidak diterima model itu, bersama sebabnya. Minta pembantu menyemak get_model untuk apa yang diterima model.

Satu nilai ditolakinvalid_<field> · invalid_arguments

Nilai itu tidak dibenarkan untuk model tersebut. Ralat menyenaraikan nilai yang dibenarkan, jadi pembantu boleh mencuba semula dengan salah satu daripadanya. Tiada caj dikenakan.

Tiada alat fcaai yang muncul

Pastikan alamat berakhir dengan /mcp. Kemudian muat semula: dalam ChatGPT, Refresh di halaman Plugins; dalam Claude, hidupkan fcaai di bawah + › Connectors; dalam Cursor, hidupkan dalam Customize; dalam VS Code, Restart Server. Masih tiada? Buang fcaai dan tambah semula.

Terlalu banyak permintaanrate_limited

Secara lalai 120 permintaan seminit bagi setiap sambungan, dan sesetengah alat mempunyai had seminitnya sendiri. Tunggu seminit dan cuba lagi.

Disekat pada rangkaian tempat kerja

Aplikasi pada komputer anda (Claude Code, Codex, Cursor, VS Code…) memerlukan akses HTTPS ke api.fcaai.ai, dan log masuk membuka fcaai.ai dalam pelayar anda. Minta pihak IT membenarkan kedua-duanya.

Soalan

Adakah penggunaan MCP dikenakan kos tambahan?

Tidak. Anda hanya membayar untuk janaan yang anda jalankan, pada harga API dalam dolar AS. Penyenaraian, sebut harga dan semakan status adalah percuma.

Adakah pelan tanpa had saya berfungsi melalui MCP?

Tidak. API, pelayan MCP dan pemalam sentiasa menggunakan baki anda. Penggunaan tanpa had meliputi Studio, Canvas dan templat di laman web dan dalam aplikasi.

Bolehkah pembantu memulakan tugas mahal tanpa bertanya?

ChatGPT dan Claude boleh bertanya kepada anda sebelum alat dijalankan, dan pelayan memberitahu pembantu supaya menyatakan harga sebelum tugas video dan 4K. Perlindungan sebenar anda ialah had bulanan yang anda tetapkan semasa bersambung (atau had belanja kunci): setelah ia dicapai, tiada tugas baharu bermula.

Di mana output disimpan?

Dalam pustaka fcaai anda, seperti semua yang anda hasilkan dalam Studio. Pembantu memberi anda pautannya, dan Claude Code, Codex serta alat terminal lain boleh menyimpan fail terus ke dalam folder anda.

Log masuk atau kunci API: yang mana patut saya guna?

Log masuk apabila aplikasi anda menawarkannya: tiada kunci untuk disalin, anda memilih akaun dan had bulanan, dan anda boleh membuang aplikasi itu dengan satu klik. Gunakan kunci API untuk skrip, CI dan persediaan yang tiada sesiapa boleh log masuk melalui pelayar.

Siapa yang boleh menggunakan pelayan MCP?

Mana-mana akaun fcaai, peribadi atau pasukan. Larian dibayar daripada baki akaun itu pada harga API, tanpa mengira pelan anda.

Apa yang berlaku jika larian gagal?

Jumlah yang ditempah dikembalikan secara automatik. Jika laluan biasa sesebuah model gagal, kami mencuba semula pada laluan sandaran dengan harga yang sama.