图片 MCP

Claude Code 和其他支持 Streamable HTTP 的客户端可以使用 TokenFlux 图片生成 MCP 服务器。端点为 https://tokenflux.ai/studio/mcp。

你需要一个有权使用受支持图片模型的 TokenFlux API key，账户也需要足够余额。New API 负责检查密钥、模型权限和余额。生成操作按模型目录所列的每次请求价格计费。目录标价不包含账户分组倍率调整。

连接 Claude Code复制标题链接

在 Claude Code 的进程环境中设置 TOKENFLUX_API_KEY。不要将密钥提交到版本控制。在 MCP 配置中加入以下内容：

{
  "mcpServers": {
    "tokenflux-studio": {
      "type": "http",
      "url": "https://tokenflux.ai/studio/mcp",
      "headers": {
        "Authorization": "Bearer ${TOKENFLUX_API_KEY}"
      }
    }
  }
}

在 Claude Code 中打开 /mcp 检查连接。先让客户端列出图片模型，再让客户端生成图片。其他客户端必须发送相同的 Bearer 请求头，并支持 Streamable HTTP 的 JSON 响应。

工具复制标题链接

image_models__list 接收空对象。工具只返回当前密钥可访问、且 TokenFlux 已验证图片生成能力的模型。每个模型包含 ID、generate 操作和固定为一张的图片数量。目录价格为可选字段。如果价格服务不可用，响应包含 pricing_status: "unavailable"。

images__generate 接收模型 ID 和提示词：

{
  "model": "image/black-forest-labs/flux-2-klein-4b",
  "prompt": "A plain blue circle on a white background"
}

工具每次生成一张图片。工具返回 model、created 和 images 中的一个 HTTPS URL，并在可用时返回 request_id。结果同时提供结构化内容和 JSON 文本。如果需要保留图片，请下载图片。供应商 URL 可能过期。

限制与错误复制标题链接

• 提示词必须包含非空白文本，最多 4,000 个字符。模型 ID 最多 200 个字符。
• 请省略 size。当前模型尚未验证自定义尺寸。
• 每次调用生成一张图片。首版不支持编辑、多图、内联 base64、自定义供应商字段或后台任务恢复。
• 请求体上限为 64 KiB。上游 JSON 响应上限为 1 MiB。目录请求截止时间为 10 秒。生成截止时间为 120 秒。
• 请将客户端超时设为大于 120 秒。如果工具返回 outcome_unknown，请先检查用量，再决定是否重试。超时或客户端断开不能证明生成已停止，也不能证明没有扣费。重复调用可能重复扣费。
• 缺失或无效的密钥返回 HTTP 401。权限错误返回 403。生成请求被拒绝时，工具错误包含 upstream_status，并在可用时包含 request_id 和 retry_after_seconds。

服务器接受 POST 请求和通知。服务器没有持久会话或 GET 事件流。GET 和 DELETE 返回 405。CLI 客户端可以省略 Origin。带有 Origin 的请求必须匹配部署配置的允许列表。首版不开放浏览器 CORS。

该端点不会给 TokenFlux Agent 添加内置图片工具。已退役的 /v1/images/mcp 和 /v1/mcps 不是新端点的别名。