---
title: beadloom-studio
canonical_url: "https://www.modelscope.cn/studios/OceanZhengYang/beadloom-studio"
md_url: "https://www.modelscope.cn/studios/OceanZhengYang/beadloom-studio.md"
repository: OceanZhengYang/beadloom-studio
chinese_name: "拼豆工坊· Beadloom"
last_updated: 2026-08-12
sdk_type: gradio
sdk_version: 6.17.3
downloads: 0
stars: 66
---

# beadloom-studio

> beadloom-studio - OceanZhengYang 在 ModelScope 创建的在线 Demo。把图片转换成可制作、可打印的拼豆图纸

OceanZhengYang/beadloom-studio 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 gradio 6.17.3 构建，中文名为「拼豆工坊· Beadloom」。

- **Repository**: OceanZhengYang/beadloom-studio
- **SDK**: gradio
- **SDK version**: 6.17.3
- **Downloads**: 0
- **Stars**: 66
- **Last updated**: 2026-08-12

Source: https://www.modelscope.cn/studios/OceanZhengYang/beadloom-studio

---

# 拼豆工坊· Beadloom

把上传的图片转换成可制作的拼豆图纸：支持网格尺寸、最多颜色数、智能/主题色板、裁切、去背景、渐变抖动、杂点清理、29×29 底板规划、材料统计，以及 PNG / CSV / 分页 PDF 导出。

应用内色号用于图纸编号，不代表任何拼豆品牌的官方色号。屏幕显示与实物存在色差，批量购买前请使用实物色卡核对。

## MCP 服务

本项目同时提供 Streamable HTTP MCP 服务。连接地址：

```text
https://studio-oceanzhengyang-beadloom-studio.api-inference.modelscope.net/gradio_api/mcp/
```

### 客户端配置

```json
{
  "mcpServers": {
    "beadloom": {
      "type": "streamable_http",
      "url": "https://studio-oceanzhengyang-beadloom-studio.api-inference.modelscope.net/gradio_api/mcp/",
      "headers": {
        "Authorization": "Bearer ${MODELSCOPE_API_TOKEN}"
      }
    }
  }
}
```

将环境变量 `MODELSCOPE_API_TOKEN` 设置为你自己的 ModelScope Access Token。可在
[ModelScope 访问令牌页面](https://modelscope.cn/my/myaccesstoken)创建令牌；请求头中的
`Bearer` 与令牌之间必须保留一个空格。不要把令牌直接提交到仓库或公开配置中。

MCP 只暴露一个工具：`create_bead_pattern`。它接收可公开访问的图片 URL，并返回拼豆质感预览、编号施工图、机器可读 JSON，以及包含 PNG、CSV、分页 PDF 的完整 ZIP 文件。

### 参数说明

| 参数 | 范围 / 可选值 | 建议 |
|---|---|---|
| `width` | 12–128 | 小挂件 24–40；头像约 58；细节大图 87+ |
| `max_colors` | 4–64 | 插画常用 12–24；照片常用 24–40 |
| `palette` | `smart_original` / `universal_48` / `candy_24` / `morandi_24` / `retro_16` | 不确定时选 `smart_original` |
| `crop` | `keep` / `square` / `portrait_4_5` / `landscape_16_9` | 头像与角色常用 `square` |
| `detail` | `illustration` / `photo` / `pixel` | 卡通选 `illustration`；像素画选 `pixel` |
| `dithering` | 布尔值 | 照片可开，Logo 和像素画建议关闭 |
| `cleanup` | 0–3 | 保留小细节用 0；常规图纸用 1–2 |
| `remove_background` | 布尔值 | 仅纯色或近似纯色背景建议开启 |
| `background_tolerance` | 4–60 | 越大去除越多；默认 22 |
| `bead_size_mm` | 5.0 / 2.6 | Midi 选 5.0，Mini 选 2.6 |

> 远程 MCP 调用的图片必须能被服务器通过 HTTP/HTTPS 访问。本地文件可先上传到可访问地址，或配合 Gradio 的 `upload-mcp` 文件上传工具使用。