English Français العربية

Modelflare

Registre officiel Médias et design

Image and video generation with one Modelflare Smart API Key.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @modelflare/mcp-server
Claude Code 
claude mcp add modelflare -e 'MODELFLARE_API_KEY=<your modelflare_api_key>' -e 'MODELFLARE_BASE_URL=<MODELFLARE_BASE_URL>' -e 'MODELFLARE_OUTPUT_DIR=<MODELFLARE_OUTPUT_DIR>' -- npx -y @modelflare/mcp-server@0.1.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "modelflare": {
            "command": "npx",
            "args": [
                "-y",
                "@modelflare/mcp-server@0.1.2"
            ],
            "env": {
                "MODELFLARE_API_KEY": "<your modelflare_api_key>",
                "MODELFLARE_BASE_URL": "<MODELFLARE_BASE_URL>",
                "MODELFLARE_OUTPUT_DIR": "<MODELFLARE_OUTPUT_DIR>"
            }
        }
    }
}

Variables d'environnement

  • MODELFLARE_API_KEY obligatoire secret Modelflare Smart API Key (create one at https://modelflare.dev/keys)
  • MODELFLARE_BASE_URL global (default), china, or a custom base URL
  • MODELFLARE_OUTPUT_DIR Directory for generated images and videos (default ./modelflare-output)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Modelflare MCP Server
  2. Get a Smart API Key / 获取 Smart API Key
  3. Configure / 配置
  4. Tools / 工具
  5. Troubleshooting / 常见问题
  6. Links
  7. License

Modelflare MCP Server

Image and video generation for any MCP client — Claude Desktop, Cursor, Gemini CLI and more — with one Modelflare Smart API Key for every image and video model available to your account.

用一个 Modelflare Smart API Key，在任意 MCP 客户端里调用你账号可用的全部图像和视频模型。

mcp-name: io.github.castaly-ai/mcp-server

Get a Smart API Key / 获取 Smart API Key

  1. Sign up / 注册: https://modelflare.dev/sign-up?utm_source=mcp-registry&utm_medium=plugin&utm_campaign=integrations

  2. Console → API Keys → Create Smart API Key, and pick a routing strategy (Balanced / Stability first / Low price first).

    控制台 API Keys →「Create Smart API Key」，选择路由策略（均衡 / 稳定优先 / 低价优先）。

Configure / 配置

Add the server to your MCP client:

{
  "mcpServers": {
    "modelflare": {
      "command": "npx",
      "args": ["-y", "@modelflare/mcp-server"],
      "env": {
        "MODELFLARE_API_KEY": "<your Smart API Key>"
      }
    }
  }
}
VariableValue
MODELFLARE_API_KEYyour Smart API Key (required)
MODELFLARE_BASE_URLglobal → https://modelflare.dev/v1 (default) · china → https://origin.modelflare.dev/v1 · or a custom URL
MODELFLARE_OUTPUT_DIRwhere images and videos are saved (default ./modelflare-output)
MODELFLARE_LOCALEen (default) or zh for error messages

Claude Desktop: download modelflare-mcp-<version>.mcpb from Releases and open it; Claude Desktop asks for the API key, base URL and output folder. modelflare-mcp-<version>-smithery.mcpb is the same bundle with each tool's inputSchema in the manifest, as Smithery requires. node build-mcpb.mjs rebuilds both.

Tools / 工具

ToolWhat it does
list_modelsImage and video models your key can call, each with the docs page holding its exact request fields. kind: "text" lists text models.
generate_imageGenerates an image, or edits one with edit: true, and saves it. Gemini image models use generateContent; the others use the Images API.
create_videoStarts an asynchronous video task and returns its task ID.
get_video_statusStatus and progress of a video task.
download_videoSaves a finished video; can wait up to 300 seconds first.

Model-specific fields go in parameters (images) or request (videos) and are sent unchanged. The model list comes from your key, so new models appear without editing the key. Generated results are saved right away because result URLs expire.

Calls are billed to your Modelflare balance by actual usage; see https://modelflare.dev/usage-logs.

Troubleshooting / 常见问题

  • 401: the key is missing or invalid. Create a Smart API Key at https://modelflare.dev/keys.
  • model_not_found: a regular key only calls the models of its own group. A Smart API Key calls every model available to your account. If you already use a Smart API Key, that model is not available to your account right now.
  • 403 insufficient_user_quota: top up at https://modelflare.dev/billing.

Docs: https://docs.modelflare.dev/ · Pricing: https://modelflare.dev/pricing

License

MIT © Havenbyte LLC

Questions fréquentes

Qu'est-ce que Modelflare ?

Image and video generation with one Modelflare Smart API Key.

Comment installer Modelflare ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add modelflare -e 'MODELFLARE_API_KEY=<your modelflare_api_key>' -e 'MODELFLARE_BASE_URL=<MODELFLARE_BASE_URL>' -e 'MODELFLARE_OUTPUT_DIR=<MODELFLARE_OUTPUT_DIR>' -- npx -y @modelflare/mcp-server@0.1.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Modelflare ?

Oui. Il attend MODELFLARE_API_KEY, à renseigner dans sa configuration.

Modelflare est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Modelflare ?

Il est publié par castaly-ai. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.