编程

3d-generator

试用

AI Generated 3D Models using SOTA APIs such as Tripo/Meshy/TripoSR/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Game, Figurine, Stuffed Toy Generation

它能做什么

AI Generated 3D Models using SOTA APIs such as Tripo/Meshy/TripoSR/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Game, Figurine, Stuffed Toy Generation

技能文档

3d-generator Skills from craftsman-agent

The Workflow of typical 3D Model Generation is like below. This 3D generation APIs served on OneKey Gateway include the vendors from "TripoAI", "Meshy" APIs and used on Craftsman Agent 3D/IP/Toy Designer Agent website consoles (https://craftsman-agent.aiagenta2z.com/app/3d-generator).

[Text/Single Images/Multi View Images Prompt]  ->  [Create Generation Task: Task ID] -> [Poll Task Results Progress using Task ID]
APIDescription
3d_generator_task_createCreate a new 3D Generation Task From user uploaded images or text prompts
3d_generator_task_pollPoll Progress of Task Generation

3D Generation API Types

API TYPEDescription
image_to_model3D Reconstruction from user uploaded images and outputs a .obj,.pbr 3d files
text_to_modelPoll Progress of Task Generation
multiview_to_modelGenerate a 3D model assets using front, left, right, back views of the same character

Auto-generated skill for OneKey Agent Gateway registered agent craftsman-agent/craftsman-agent based on its api_list from registered API metas. Available to use in CLIs, Skills, Rest APIs, and more agent preferred formats. The online 3D generator website is https://craftsman-agent.aiagenta2z.com/app/3d-generator. And you can also find gallery of 3D Generated Digital Assets in https://craftsman-agent.aiagenta2z.com/gallery/3d_generator.

SectionDescription
Craftsman 3D Generator Onlinehttps://craftsman-agent.aiagenta2z.com/app/3d-generator
Craftsman Websitehttps://craftsman-agent.aiagenta2z.com
Craftsman Apphttps://craftsman-agent.aiagenta2z.com/app
Craftsman Galleryhttps://craftsman-agent.aiagenta2z.com/gallery
Craftsman Workspacehttps://craftsman-agent.aiagenta2z.com/workspace
Craftsman Marketplacehttps://craftsman-agent.aiagenta2z.com/marketplace

Quick Start

Set the registered OneKey Gateway access key DEEPNLP_ONEKEY_ROUTER_ACCESS from AI Agent Marketplace at the Website.

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

1. Text to Model

1.1 Curl Request

Task Create API

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "3d_generator_task_create",
  "data": {
    "prompt": "Generate A Figurine of Steve in Minecraft",
    "images": [],
    "provider_model_id": "tripo/tripo",
    "session_name": "3D Build Plan",
    "tag_list": "",
    "mode": "basic"
  }
}'

Input Parameters Definition

ParametersDescription
promptText Prompt
imagesArray of image URLs
provider_model_idoptions: tripo/tripo,meshy/meshy
modebasic/standard/advanced/demo

Expected Outputs

{
  "provider_model_id": "tripo/tripo",
  "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
  "session_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
  "title": "3D Build Plan",
  "workspace_session_id": "",
  "tag_list": "",
  "final_image_url": "",
  "status": "running"
}

Outputs Parameters Definition

ParametersDescription
provider_model_idThe 3D Generator provider id, such as "tripo/tripo", "meshy/meshy",
task_idThe Task ID of created 3d generator Task
session_idThe generated workspace session ID, you can view your session on workspace at https://craftsman-agent.aiagenta2z.com/workspace for logged in user.
statusrunning,completed,etc

Task Poll API

Input Parameters Definition

ParametersDescription
data.task_idThe task id to poll status
data.kwargsOther optional parameters

Input Request

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "3d_generator_task_poll",
  "data": {
    "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
    "kwargs": {
      "provider_model_id": "tripo/tripo",
      "mode": "basic"
    }
  }
}'

Outputs Parameters Definition

ParametersDescription
task_idThe task id of generated 3d model
statusThe status of generated task
progress0-100, int, progress of Task
model3D model downloadable urls
previewThe rendering preview of the 3d model
creditsCredits consumed for each 3D generation Task
raw_outputThe original raw outputs of tripo3d.ai or meshy.ai

Expected Outputs

{
  "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
  "status": "success",
  "progress": 100,
  "model": {
    "url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/tripo_pbr_model_96b2116e-4b86-4d3c-af04-baf0da0c23ac.glb",
    "type": "glb"
  },
  "preview": {
    "url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/legacy_mesh.webp",
    "type": "webp"
  },
  "metadata": {
    "model_version": "P1-20260311",
    "texture": true,
    "pbr": true,
    "face_limit": null,
    "export_uv": true
  },
  "credits": 50,
  "raw_output": {
    "code": 0,
    "status": "success",
    "data": {
      "type": "multiview_to_model",
      "status": "success",
      "progress": 100,
      "input": {
        "pbr": true,
        "files": [
          {
            "object": {
              "key": "tcli_0bc797f67ec048078fb528e60503c957/20260814/96b2116e-4b86-4d3c-af04-baf0da0c23ac/url_fetch/mv_0.png",
              "bucket": "tripo-data"
            }
          },
          null,
          {
            "object": {
              "key": "tcli_0bc797f67ec048078fb528e60503c957/20260814/96b2116e-4b86-4d3c-af04-baf0da0c23ac/url_fetch/mv_2.png",
              "bucket": "tripo-data"
            }
          },
          {
            "object": {
              "key": "tcli_0bc797f67ec048078fb528e60503c957/20260814/96b2116e-4b86-4d3c-af04-baf0da0c23ac/url_fetch/mv_3.png",
              "bucket": "tripo-data"
            }
          }
        ],
        "texture": true,
        "export_uv": true,
        "model_version": "P1-20260311"
      },
      "output": {
        "model_url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/tripo_pbr_model_96b2116e-4b86-4d3c-af04-baf0da0c23ac.glb",
        "rendered_image_url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/legacy_mesh.webp",
        "model_url_original": "https://tripo-data.rg1.data.tripo3d.com/tcli_0bc797f67ec048078fb528e60503c957/20260814/96b2116e-4b86-4d3c-af04-baf0da0c23ac/tripo_pbr_model_96b2116e-4b86-4d3c-af04-baf0da0c23ac.glb?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly90cmlwby1kYXRhLnJnMS5kYXRhLnRyaXBvM2QuY29tL3RjbGlfMGJjNzk3ZjY3ZWMwNDgwNzhmYjUyOGU2MDUwM2M5NTcvMjAyNjA4MTQvOTZiMjExNmUtNGI4Ni00ZDNjLWFmMDQtYmFmMGRhMGMyM2FjL3RyaXBvX3Bicl9tb2RlbF85NmIyMTE2ZS00Yjg2LTRkM2MtYWYwNC1iYWYwZGEwYzIzYWMuZ2xiIiwiQ29uZGl0aW9uIjp7IkRhdGVMZXNzVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxNzg2Nzc3MzI1fX19XX0_&Signature=N9WpKJRtdSBN36~6QuF2ujoONVnZARvHaZ5Mx5urx1WdYcgUGZ4QV9uhIFyEEt~Kbx6k6ATIlA08nD7pV76ELabEyvhtq6AUUxmTSyf-EtdDJdfCFB~7L8LufrXlHrBw29sEtr5jFzJc7qnqw556Y-0FlTgOXDk0V-t5DJJOIvIy31kvMuYQ3TiXY8uw6DIurKlTfy4BzPqgRcn6oHXlqOs2NMyoINKw2B62MzMLqUlf4w8k5rPOkl8twLGk0hbt93MMVpjZ24NgcBSck8Y4~JWIjitEPmb1swhnOSNMiUEIKQkffcG1xIKuEYcQshdEDpQRq1aUh6KxzplfuyN-iw__&Key-Pair-Id=K1676C64NMVM2J",
        "rendered_image_url_original": "https://tripo-data.rg1.data.tripo3d.com/tcli_0bc797f67ec048078fb528e60503c957/20260814/96b2116e-4b86-4d3c-af04-baf0da0c23ac/legacy_mesh.webp?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly90cmlwby1kYXRhLnJnMS5kYXRhLnRyaXBvM2QuY29tL3RjbGlfMGJjNzk3ZjY3ZWMwNDgwNzhmYjUyOGU2MDUwM2M5NTcvMjAyNjA4MTQvOTZiMjExNmUtNGI4Ni00ZDNjLWFmMDQtYmFmMGRhMGMyM2FjL2xlZ2FjeV9tZXNoLndlYnAiLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE3ODY3NzczMjV9fX1dfQ__&Signature=Xy4anDZvmQX8Oe6z9TuPAqtTZYs1zTpXN7a2Ex2M5UTg-nYxVnCPze82cChCP9joJWg8IbdiRMTBEYy3aFT6uxPu~XzrxF2~m8mRQhsTwkm0WETlGcVSTeSfNiCXXCmZPsfA~UT5~tURgKeiXuh9XuLK100vakVbxxkAxwK0EG4KS8u-CwsMLYBwyml9Th-AIeCegr9WHNAnrMX9L5uIDdF0mcRDJO7aOc9caUEvFQGgG0K9zCuWbiCCqh2IcirEXp0PBvMwYXwjR2-pKqWjWQ-TFeGlZeKYadVaOX45V5jDn1mkMjSQt3kJbrXYY6WBbUPk0n9gCTQoidpWCt2Dyw__&Key-Pair-Id=K1676C64NMVM2J"
      },
      "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
      "created_at": "2026-08-14T06:59:54.087075Z",
      "completed_at": "2026-08-14T07:01:13.058416Z",
      "credits_consumed": 50
    }
  },
  "session_id": "",
  "title": "",
  "workspace_session_id": "",
  "tag_list": ""
}

1.2 CLIs Usage

npx onekey agent craftsman-agent/craftsman-agent 3d_generator_task_create '{"prompt": "Generate A Figurine of Steve in Minecraft", "images": [], "provider_model_id": "tripo/tripo", "session_name": "3D Build Plan", "tag_list": "", "mode": "basic"}'

npx onekey agent craftsman-agent/craftsman-agent 3d_generator_task_poll '{"task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac", "kwargs": {"provider_model_id": "tripo/tripo", "mode": "basic"}}'

2. Image to Model

2.1 Curl Request

a. Task Create API Demo

Input Parameters Definition

ParametersDescription
promptText Prompt
imagesArray of image URLs
provider_model_idoptions: tripo/tripo,meshy/meshy
modebasic/standard/advanced/demo
export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "3d_generator_task_create",
  "data": {
    "prompt": "",
    "images": ["https://us-static.aiagenta2z.com/local/files-wd/onekey_llm_router/7485ee2a-ae58-48e3-9dc8-eaf1d3d1c4a7.png"],
    "provider_model_id": "tripo/tripo",
    "session_name": "3D Build Plan",
    "tag_list": "",
    "mode": "basic"
  }
}'

Input Parameters Definition

ParametersDescription
provider_model_idThe provider model id
task_idThe task if for polling...

Expected Outputs

{"provider_model_id":"tripo/tripo","task_id":"96b2116e-4b86-4d3c-af04-baf0da0c23ac","session_id":"96b2116e-4b86-4d3c-af04-baf0da0c23ac","title":"3D Build Plan","workspace_session_id":"","tag_list":"","final_image_url":"https://static.aiagenta2z.com/container/craftsman-agent/default/static/derekzz/a49f905b-4e0d-40c6-af7a-c37be3d1741e/3ccb042bbd9b41c3a9f5d31c564ef4c0.png","status":"running"}

b. Task Poll API

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "3d_generator_task_poll",
  "data": {
    "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
    "kwargs": {
      "provider_model_id": "tripo/tripo",
      "mode": "basic"
    }
  }
}'

Input Parameters Definition

ParametersDescription
task_idThe ID of the task generated from task create API
kwargsExtra parameters like provider_model_id and mode

Expected Outputs

{
  "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
  "status": "success",
  "progress": 100,
  "model": {
    "url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/tripo_pbr_model_96b2116e-4b86-4d3c-af04-baf0da0c23ac.glb",
    "type": "glb"
  },
  "preview": {
    "url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/legacy_mesh.webp",
    "type": "webp"
  },
  "metadata": {
    "model_version": "P1-20260311",
    "texture": true,
    "pbr": true,
    "face_limit": null,
    "export_uv": true
  },
  "credits": 50
}

2.2 CLIs Usage

npx onekey agent craftsman-agent/craftsman-agent 3d_generator_task_create '{"prompt": "", "images": ["https://us-static.aiagenta2z.com/local/files-wd/onekey_llm_router/7485ee2a-ae58-48e3-9dc8-eaf1d3d1c4a7.png"], "provider_model_id": "tripo/tripo", "session_name": "3D Build Plan", "tag_list": "", "mode": "basic"}'

npx onekey agent craftsman-agent/craftsman-agent 3d_generator_task_poll '{"task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac", "kwargs": {"provider_model_id": "tripo/tripo", "mode": "basic"}}'

3. MultiView to Model

3.1 Curl Request

Inputs Parameters Definition

ParametersDescription
promptText Prompt
imagesArray of image URLs
multi_viewThe multi_view is a dict of front,left(optional),right,back images urls for 3D reconstruction
provider_model_idoptions: tripo/tripo,meshy/meshy
modebasic/standard/advanced/demo

Task Create API

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "3d_generator_task_create",
  "data": {
    "prompt": "",
    "images": ["https://static.aiagenta2z.com/container/craftsman-agent/default/static/derekzz/a49f905b-4e0d-40c6-af7a-c37be3d1741e/3ccb042bbd9b41c3a9f5d31c564ef4c0.png"],
    "multi_view": {
        "front": "https://craftsman-agent.aiagenta2z.com/static/derekzz/75302fb3-b0f4-4bfe-a406-1c97eda64dbf/build_front.png",
        "right": "https://craftsman-agent.aiagenta2z.com/static/derekzz/75302fb3-b0f4-4bfe-a406-1c97eda64dbf/build_right.png",
        "back": "https://craftsman-agent.aiagenta2z.com/static/derekzz/75302fb3-b0f4-4bfe-a406-1c97eda64dbf/build_back.png"
    },
    "provider_model_id": "tripo/tripo",
    "session_name": "3D Build Plan",
    "tag_list": "",
    "mode": "basic"
  }
}'

Expected Outputs

{"provider_model_id":"tripo/tripo","task_id":"96b2116e-4b86-4d3c-af04-baf0da0c23ac","session_id":"96b2116e-4b86-4d3c-af04-baf0da0c23ac","title":"3D Build Plan","workspace_session_id":"","tag_list":"","final_image_url":"https://static.aiagenta2z.com/container/craftsman-agent/default/static/derekzz/a49f905b-4e0d-40c6-af7a-c37be3d1741e/3ccb042bbd9b41c3a9f5d31c564ef4c0.png","status":"running"}

Task Poll API

export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key

curl -X POST "https://agent.deepnlp.org/agent_router" \
-H "Content-Type: application/json" \
-H "X-OneKey: $DEEPNLP_ONEKEY_ROUTER_ACCESS" \
-d '{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "3d_generator_task_poll",
  "data": {
    "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
    "kwargs": {
      "provider_model_id": "tripo/tripo",
      "mode": "basic"
    }
  }
}'

Expected Outputs

{
  "task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
  "status": "success",
  "progress": 100,
  "model": {
    "url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/tripo_pbr_model_96b2116e-4b86-4d3c-af04-baf0da0c23ac.glb",
    "type": "glb"
  },
  "preview": {
    "url": "https://us-static.aiagenta2z.com/container/aiagenta2z/3d_generator/static/96b2116e-4b86-4d3c-af04-baf0da0c23ac/legacy_mesh.webp",
    "type": "webp"
  }
}

3.2 CLIs Usage

npx onekey agent craftsman-agent/craftsman-agent 3d_generator_task_create '{"prompt": "", "images": ["https://static.aiagenta2z.com/container/craftsman-agent/default/static/derekzz/a49f905b-4e0d-40c6-af7a-c37be3d1741e/3ccb042bbd9b41c3a9f5d31c564ef4c0.png"], "multi_view": {"front": "https://craftsman-agent.aiagenta2z.com/static/derekzz/75302fb3-b0f4-4bfe-a406-1c97eda64dbf/build_front.png", "right": "https://craftsman-agent.aiagenta2z.com/static/derekzz/75302fb3-b0f4-4bfe-a406-1c97eda64dbf/build_right.png", "back": "https://craftsman-agent.aiagenta2z.com/static/derekzz/75302fb3-b0f4-4bfe-a406-1c97eda64dbf/build_back.png"}, "provider_model_id": "tripo/tripo", "session_name": "3D Build Plan", "tag_list": "", "mode": "basic"}'

npx onekey agent craftsman-agent/craftsman-agent 3d_generator_task_poll '{"task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac", "kwargs": {"provider_model_id": "tripo/tripo", "mode": "basic"}}'

相关技能

3d-printing-generator

AI 3D Printing Toy Generator Toy Multi View Sheets and 3D Models Generator using SOTA 3D APIs such as Tripo/Meshy/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Figurine, Stuffed Toy, 3D Printing, Game Asset and Architecture Toy Generation

2 次安装1 星标

figurine-generator

AI Figurine Generator Generated Toy Multi View Sheets and 3D Models Generator using SOTA 3D APIs such as Tripo/Meshy/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Figurine, Stuffed Toy, 3D Printing, Game Asset and Architecture Toy Generation

game-asset-generator

AI Game Asset Toy Generator Generate Toy Multi View Sheets and 3D Models Generator using SOTA 3D APIs such as Tripo/Meshy/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Figurine, Stuffed Toy, 3D Printing, Game Asset and Architecture Toy Generation

toy-generator

AI Generated Toy Models using SOTA 3D APIs such as Tripo/Meshy/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Figurine, Stuffed Toy, 3D Printing, Game Asset and Architecture Toy Generation

architecture-generator

AI Architecture Toy Generator Generate Toy Multi View Sheets and 3D Models Generator using SOTA 3D APIs such as Tripo/Meshy/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Figurine, Stuffed Toy, 3D Printing, Game Asset and Architecture Toy Generation

stuffed-toy-generator

AI Stuffed Toy Generator Generated Toy Multi View Sheets and 3D Models Generator using SOTA 3D APIs such as Tripo/Meshy/etc served on OneKey Agent Gateway by Craftsman Agent, useful for AI Figurine, Stuffed Toy, 3D Printing, Game Asset and Architecture Toy Generation