Meshy AI

封装 Meshy.ai REST API 的 Python 脚本：用 text_to_image.py 由文本提示生成 2D 图片，用 image_to_3d_obj.py 由本地图片或公网图片 URL 生成 3D 模型；脚本负责创建异步任务、轮询直至 SUCCEEDED，并把图片、model.obj（含 model.mtl）下载到指定输出目录，需环境变量 MESHY_API_KEY。

sabatesduran

热度 91.72

最近更新 2026-05-11 15:50:48

分类：创作依赖：代码执行 / 读写文件 / 第三方 API应用场景：图像生成 / API 集成 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add clawdbot-meshyai-skill

Metadata

name: meshy-ai
description: Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires MESHY_API_KEY in the environment.

Meshy.ai

Generate Meshy assets via API and save outputs locally.

Setup

Add env var: MESHY_API_KEY=msy-...
Optional: MESHY_BASE_URL (defaults to https://api.meshy.ai)

Text → 2D (Text to Image)

Use scripts/text_to_image.py.

python3 skills/public/meshy-ai/scripts/text_to_image.py \
  --prompt "a cute robot mascot, flat vector style" \
  --out-dir ./meshy-out

Downloads one or more images (if multi-view) into ./meshy-out/text-to-image_<taskId>_<slug>/.

Image → 3D (always save OBJ)

Use scripts/image_to_3d_obj.py.

Local image

python3 skills/public/meshy-ai/scripts/image_to_3d_obj.py \
  --image ./input.png \
  --out-dir ./meshy-out

Public URL

python3 skills/public/meshy-ai/scripts/image_to_3d_obj.py \
  --image-url "https://.../input.png" \
  --out-dir ./meshy-out

Always downloads model.obj (and model.mtl if provided by Meshy) into ./meshy-out/image-to-3d_<taskId>_<slug>/.

Notes

Meshy tasks are async: create → poll until status=SUCCEEDED → download URLs.
API reference for this skill: references/api-notes.md.