Image To 3d Pipeline

一键将商品图片转换为高质量3D模型的自动化流水线（图片预处理 → AI增强 → 3D生成）

Security Scan

技能声称将商品图片一键转为3D模型，但运行说明在多个地方引用未声明或不一致的外部服务/环境变量（例如 meshy.ai / MESHY_API_KEY），说明文档与所需凭据不完全匹配，值得谨慎对待。

Purpose & Capability

技能名称和主要需求（TRIPOSR_API_KEY，用于调用 Tripo3D/Replicate）与其主要功能一致，但文档同时引用了多家第三方服务（Replicate、meshy.ai、remove.bg、upscale.ai），且某些服务（meshy.ai）在 requires.env 中未声明，导致所需权限与说明不一致。

Instruction Scope

SKILL.md 指示运行多条 curl 请求并上传/下载图片到外部服务，这在功能上合理，但说明里出现不一致的调用示例（先用 Replicate 提交任务，随后轮询却访问 meshy.ai 并使用未声明的 MESHY_API_KEY），增加了不透明性和误配置风险。

Install Mechanism

无安装说明且仅为 instruction-only（没有下载或执行外部二进制），这降低了磁盘写入或隐式安装的风险。

Credentials

manifest 要求仅 TRIPOSR_API_KEY（并把 REMOVE_BG_API_KEY/UPSCALE_API_KEY 标为可选），但运行示例还引用 MESHY_API_KEY 和可能的其它凭据——这些未在 requires.env 中声明，表明所需凭据和实际运行不一致，可能导致用户不知情地暴露额外 API key。

Persistence & Privilege

技能未设置 always:true，默认可由模型调用且不持久化或修改其它技能/系统配置，权限范围受限且符合常规预期。

What to consider before installing

这项技能在总体目的上看起来合理（将图片转为3D 模型），但 SKILL.md 包含明显的不一致：示例先用 Replicate/ TRIPOSR_API_KEY 提交任务，随后又用 meshy.ai 的轮询流程并引用未声明的 MESHY_API_KEY。建议在安装/使用前： 1) 向技能作者或发布源确认真实的运行流程：到底使用 Replicate、meshy.ai 还是自托管 Tripo3D？并要求在 SKILL.md 中把所有必需的环境变量列出并一致化。 2) 不要直接向不明或不信任的技能提供长期/高权限密钥；优先使用限额/测试型 API key 进行试验。 3) 如果可能，要求提供公开仓库或主页（可验证作者与代码），并核对 curl 请求的目标域名是否与作者说明一致。 4) 在运行前阅读并理解所有 curl 示例会将图片/结果发送到哪些外部域名，避免将敏感或未授权的图片上传到未知服务。 基于上述不一致，我们将此评估为“可疑”。在作者澄清并修正说明（使所需凭据与调用一致）之前，谨慎使用该技能。

Image to 3D Pipeline - 商品图片一键转3D模型

将任意商品图片自动转化为高质量3D模型的端到端流水线工具。

功能特性

• 🖼️ 图片预处理 - 自动去除背景、标准化图片
• ✨ AI 增强 - 提升图片质量（可选）
• 🎯 3D 生成 - 调用 Tripo3D 生成 3D 模型（快手开源）
• 📦 多格式输出 - 支持 GLB/OBJ/USDZ 格式

使用前提

需要获取以下 API Key：

1. TRIPOSR_API_KEY - 必需

   • 方案A: Replicate API - https://replicate.com/baaas/triposr
   • 方案B: 自托管 - 部署 Tripo3D 开源版
   • 推荐先用 Replicate 测试，效果好再自托管

2. REMOVE_BG_API_KEY - 可选

   • 访问 https://www.remove.bg/api 获取
   • 或使用开源 rembg

3. UPSCALE_API_KEY - 可选

   • 访问 https://upscale.ai/ 获取
   • 用于提升图片质量

API 定价参考

Replicate (Tripo3D)

方案	价格
Replicate 按量	约 $0.005-0.01/次
自托管 (A100)	约 ¥2-3/小时，批量免费
Multi Image to 3D	5-15 credits

工作流

输入图片 → 背景去除 → 图片增强 → Tripo3D 生成 → 输出模型

使用方法

基本调用

用户提供商品图片 URL 或上传图片即可自动生成 3D 模型。

API 调用示例 (Replicate)

1. 提交 Tripo3D 任务

curl -X POST "https://api.replicate.com/v1/predictions" \
  -H "Authorization: Token $TRIPOSR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "abc123...",  // Tripo3D model version
    "input": {
      "image": "https://example.com/product.jpg"
    }
  }'

响应：

{
  "id": "pred_abc123",
  "status": "starting"
}

2. 查询任务状态

curl "https://api.replicate.com/v1/predictions/pred_abc123" \
  -H "Authorization: Token $TRIPOSR_API_KEY"

3. 任务完成响应：

{
  "status": "succeeded",
  "output": {
    "glb": "https://replicate.delivery/..."
  }
}

完整流程实现

Step 1: 图片预处理（去除背景）

# 使用 remove.bg API
curl -X POST "https://api.remove.bg/v1.0/removebg" \
  -H "X-Api-Key: $REMOVE_BG_API_KEY" \
  -F "image_url=https://example.com/product.jpg" \
  -F "size=auto" \
  -o no_bg.png

Step 2: 调用 Tripo3D 生成 3D

# 提交任务
TASK_RESPONSE=$(curl -s -X POST "https://api.replicate.com/v1/predictions" \
  -H "Authorization: Token $TRIPOSR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://your-processed-image-url.png",
    "enable_pbr": true,
    "background_color": "ffffff"
  }')

TASK_ID=$(echo $TASK_RESPONSE | jq -r '.task_id')

# 轮询结果（每20秒检查一次）
while true; do
  STATUS=$(curl -s "https://api.meshy.ai/v2/image-to-3d/$TASK_ID" \
    -H "Authorization: Bearer $MESHY_API_KEY" | jq -r '.status')
  
  if [ "$STATUS" == "SUCCEEDED" ]; then
    echo "3D模型生成完成！"
    break
  elif [ "$STATUS" == "FAILED" ]; then
    echo "生成失败"
    break
  fi
  
  echo "等待生成中... ($STATUS)"
  sleep 20
done

输出格式说明

格式	用途	兼容性
GLB	Web/移动端 AR	最佳，WebXR 直接支持
GLTF	Web 3D	通用
OBJ	3D 软件导入	Blender、Maya 等
USDZ	iOS AR Quick Look	苹果生态专用

错误处理

常见错误：

• INVALID_API_KEY - API Key 无效
• IMAGE_TOO_LARGE - 图片超过 20MB
• RATE_LIMIT_EXCEEDED - 请求频率超限
• PROCESSING_FAILED - 模型生成失败

进阶用法

批量处理

支持批量提交多个图片任务：

# 批量生成（需要企业版 API）
for img in "${images[@]}"; do
  curl -X POST "https://api.meshy.ai/v2/image-to-3d" \
    -H "Authorization: Bearer $MESHY_API_KEY" \
    -d "{\"image_url\": \"$img\", \"enable_pbr\": true}" &
done

自定义参数

参数	说明	默认值
enable_pbr	启用 PBR 材质	true
background_color	背景色（十六进制）	透明
texture_resolution	纹理分辨率	1024
target_model	输出格式	glb

注意事项

1. 任务时间 - 3D 生成通常需要 2-5 分钟，请耐心等待
2. 不要重复提交 - 任务有内部重试机制，重复提交会浪费资源
3. 图片质量 - 建议使用清晰、光线均匀的商品图片
4. 版权 - 确保上传的图片有合法使用权

---

一句话介绍：自动将商品图片转化为高质量3D模型的端到端流水线工具