名称： meshy-ai
描述： "使用 Meshy.ai REST API 生成资产：(1) 文本转 2D（Meshy 文本转图像）和 (2) 图像转 3D，并将输出下载到本地。适用于用户需要 Meshy 生成、轮询异步任务，特别是希望将生成的 OBJ 文件保存到磁盘的场景。需要在环境中配置 MESHY_API_KEY。"

Meshy.ai

通过 API 生成 Meshy 资产，并将输出保存到本地。

环境配置

• 添加环境变量：MESHY_API_KEY=msy-...
• 可选：设置 MESHY_BASE_URL（默认值为 https://api.meshy.ai）

文本 → 2D（文本转图像）

使用 scripts/text_to_image.py。

python3 skills/public/meshy-ai/scripts/text_to_image.py \
  --prompt "一个可爱的机器人吉祥物，扁平矢量风格" \
  --out-dir ./meshy-out

• 将一个或多个图像（如果是多视图）下载到 ./meshy-out/text-to-image_<taskId>_<slug>/ 目录中。

图像 → 3D（始终保存 OBJ 文件）

使用 scripts/image_to_3d_obj.py。

本地图像

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

公开 URL

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

• 始终将 model.obj（以及 Meshy 提供的 model.mtl，如果有）下载到 ./meshy-out/image-to-3d_<taskId>_<slug>/ 目录中。

注意事项

• Meshy 任务是异步的：创建任务 → 轮询直到 status=SUCCEEDED → 下载 URL。
• 本技能相关的 API 参考文档：references/api-notes.md。