Skip to main content
Glama

fattly — FATTLY CLI

从终端生成 AI 图像、视频、配音、虚拟形象和 UGC 广告——或通过 MCP 从 Claude 和 Cursor 等 AI 助手生成。

30+ 个 AI 模型 · 使用你 fattly.app 账户中的积分。

网站


安装

npm install -g fattly

(需要 Node.js 18+。)

Related MCP server: mcp-media-engine

快速开始

  1. 打开网站 → 仪表盘 → API 密钥 → 生成密钥。

  2. 从终端登录:

fattly login
# paste your gpx_live_… key

示例

fattly credits
fattly models

fattly generate "astronaut cat on Mars" --model nano-banana-2 --out cat.png
fattly video "ocean waves at sunset" --model kling-3-standard --out waves.mp4
fattly audio "Welcome to FATTLY" --voice Rachel --out voice.mp3
fattly audio "calm ambient" --music --seconds 30 --out music.mp3

MCP(Claude、Cursor)

同一个包也是一个 MCP 服务器——它让 AI 助手可以通过 FATTLY 生成内容。 有两种连接方式。

选项 A —— 托管(无需安装,通过 OAuth 登录)

最快的方式:将 Claude 直接连接到托管的 FATTLY MCP。无需 npm,无需粘贴密钥——你在浏览器中批准访问即可。

在 Claude 中 → 设置 → 连接器 → 添加自定义连接器,使用此 URL:

https://fattly.app/api/mcp

Claude 会自动发现登录流程,并在 fattly.app 上打开一个同意页面;批准后工具即可就绪。使用你的 fattly.app 账户和积分。

选项 B —— 本地(npx,使用你的 API 密钥)

将此添加到你的客户端的 MCP 配置中:

{
  "mcpServers": {
    "fattly": {
      "command": "npx",
      "args": ["-y", "fattly", "mcp"],
      "env": {
        "FATTLY_API_KEY": "gpx_live_YOUR_KEY"
      }
    }
  }
}

可用工具:fattly_credits、fattly_list_models、fattly_generate_image、fattly_generate_video、fattly_generate_audio。

API 地址

默认情况下,CLI/MCP 连接到登录时设置的地址(或默认地址)。你可以在登录时覆盖它(fattly login --url https://your-domain),或使用 FATTLY_API_URL 环境变量。

Available Tools

6 tools
fattly_creditsCheck credit balanceA
Read-onlyIdempotent
Inspect

Shows the current credit balance on the FATTLY account. Read-only and free — call it before an expensive generation to make sure the user has enough credits.

Inputs: no named parameters.

fattly_generate_audioGenerate a voiceover or musicAInspect

Generates AI audio: a voiceover (mode=speech) from text, or music (mode=music) from a description. Returns a link to the mp3 file. Spends credits (price in fattly_list_models → audio); refunded automatically if the generation fails.

Inputs: mode (required), text (required), voice, seconds.

fattly_generate_imageGenerate an imageAInspect

Generates an AI image from a prompt (or edits uploaded images). Returns links to the finished images. Spends credits: model price × numImages (see fattly_list_models); fails with an error if the balance is too low, and credits are refunded automatically when a generation fails. Prompts must be safe-for-work.

Inputs: prompt (required), model, numImages, aspectRatio, +2 more.

fattly_generate_videoGenerate a videoAInspect

Generates an AI video from a prompt (or from a start image). Takes a few minutes — the tool waits (up to 10 min) and returns a link to the mp4 file. Video is the most expensive operation: it spends the model's credit price (see fattly_list_models), so confirm the model and cost with the user first. Credits are refunded automatically if the generation fails.

Inputs: prompt (required), model, duration, aspectRatio, +1 more.

fattly_list_modelsList models and pricesA
Read-onlyIdempotent
Inspect

Returns available models and their cost in credits (images, video, audio). Read-only and free. Use before generating to pick the right model id and to tell the user what a generation will cost.

Inputs: category.

fattly_upload_imageUpload a local imageAInspect

Uploads a local image file (JPG, PNG or WEBP) to FATTLY and returns a public fal URL. Use this to turn a photo on disk into an inputImageUrl for editing / face-swap / image-to-video models: pass the returned URL as inputImageUrl to fattly_generate_image or fattly_generate_video. No credits are charged for the upload.

Inputs: filePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct resource/action: credits, models, upload, image generation, video generation, audio generation. No two tools overlap in purpose; the generation tools are clearly separated by output modality.

    Naming Consistency4/5

    All tools share the 'fattly_' prefix and use a consistent verb_noun pattern (list_models, upload_image, generate_image). The only minor deviation is 'fattly_credits' which is a noun rather than a verb_noun like 'get_credits' or 'check_credits'.

    Tool Count5/5

    Six tools is well-scoped for a media generation server: one for account state, one for catalog/pricing, one for input preparation, and three for the core generation modalities. Each tool earns its place.

    Completeness4/5

    The core lifecycle is covered: check credits, list models, upload input, generate image/video/audio. Minor gaps exist (no tool to fetch a generation result by ID, no explicit cancel/delete), but the server's stated purpose of generating media is fully covered.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers