- احراز هویت
- ورود با 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 · دلار آمریکا · بازگشت اعتبار اجراهای ناموفق
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 client)، این را انتخاب کنید Register automaticallyورود با fcaai
صفحه fcaai باز میشود. حساب (شخصی یا تیمی) را انتخاب کنید، سقف ماهانه را تعیین کنید و «اجازه» را بزنید. اگر تأیید دومرحلهای فعال است، کدتان را وارد کنید.در یک چت روشنش کنید
در کادر پیام، این را باز کنید + › Connectors و fcaai را روشن کنید. Claude ممکن است پیش از اجرای یک ابزار بپرسد: Allow once یا Always allow را انتخاب کنید.
در Team یا Enterprise، یک Owner میتواند fcaai را برای همه اضافه کند در Organization settings › Connectors › Add › Custom › Web. سپس هر عضو در Customize › Connectors گزینه Connect را میزند و با حساب 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 را نشانم بده، بعد این پاراگراف را با صدایی آرام و گرم بخوان.
یک قطعه بیکلام 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 میتوانند یک فایل محلی را با CLI fcaai بارگذاری کنند و از پیوندی که چاپ میشود استفاده کنند:
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 با هر مدل (ناهمگام، یک شناسه برمیگرداند)پولی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 را در مرورگر باز میکند. از بخش IT بخواهید هر دو را مجاز کند.
پرسشها
استفاده از MCP هزینه اضافه دارد؟
خیر. فقط برای تولیدهایی که اجرا میکنید، با قیمت API به دلار آمریکا میپردازید. فهرستگیری، برآورد قیمت و بررسی وضعیت رایگان است.
طرح نامحدود من در MCP کار میکند؟
خیر. API، سرور MCP و افزونهها همیشه از موجودی شما استفاده میکنند. استفاده نامحدود شامل Studio، Canvas و قالبها در وبسایت و برنامه است.
دستیار میتواند بدون پرسیدن کار گرانی را شروع کند؟
ChatGPT و Claude میتوانند پیش از اجرای ابزار از شما بپرسند و سرور به دستیار میگوید پیش از کارهای ویدیو و 4K قیمت را اعلام کند. محافظ واقعی شما سقف ماهانهای است که هنگام اتصال تعیین میکنید (یا سقف هزینه کلید): وقتی پر شود، کار جدیدی شروع نمیشود.
خروجیها کجا ذخیره میشوند؟
در کتابخانه fcaai شما، مثل هر چیزی که در Studio میسازید. دستیار پیوند را به شما میدهد و Claude Code، Codex و دیگر ابزارهای ترمینال میتوانند فایل را مستقیم در پوشه شما ذخیره کنند.
ورود یا کلید API: کدام را استفاده کنم؟
وقتی برنامهتان امکان ورود میدهد، وارد شوید: کلیدی برای کپی کردن نیست، حساب و سقف ماهانه را انتخاب میکنید و با یک کلیک میتوانید برنامه را حذف کنید. کلید API را برای اسکریپتها، CI و جاهایی به کار ببرید که کسی نمیتواند با مرورگر وارد شود.
چه کسی میتواند از سرور MCP استفاده کند؟
هر حساب fcaai، شخصی یا تیمی. هزینه اجراها با قیمت API از موجودی همان حساب پرداخت میشود؛ طرحتان هر چه باشد.
اگر اجرا ناموفق شود چه میشود؟
مبلغ رزروشده خودکار برمیگردد. اگر مسیر معمول یک مدل ناموفق شود، با همان قیمت از مسیر پشتیبان دوباره تلاش میکنیم.


