AI Architecture Toy generator designer skills from craftsman-agent
The Workflow of typical Architecture Toy Generation is shown as below. These Toy Generation APIs are served through the OneKey Agent Gateway and used by the Craftsman Agent Toy Designer website console.
The typical workflow is:
[Text/Image Prompt]
->
[Toy Design Draft / Multi-View Sheet]
->
[Create 3D Generation Task: Task ID]
->
[Poll Task Results Progress using Task ID]
->
[3D Toy Model + Preview]
| API | Description |
|---|---|
| toy_generator_design_draft | Generate a toy design draft and multi-view reference sheets from text prompts and/or images |
| toy_generator_task_create | Create a new Toy 3D Generation Task from images, prompts, and/or multi-view references |
| toy_generator_task_poll | Poll the progress and final results of a Toy 3D Generation Task |
Toy Generation Templates
| Template ID | Template Name | Description |
|---|---|---|
| figurine | Figurine | AI Figurine Design with optional textures |
| stuffed-toy | Stuffed Toy | Stuffed Toy Template for plush texture and stuffed materials |
| 3d-printing | 3D Printing | 3D Printed Toy Design Generation, outputs ready-to-use 3D model files |
| game-assets | Game Assets | Game Design Assets |
| architecture | Architecture | Architecture Toy Design |
Toy Generator Templates Models and Asset Sizes
| template_id | asset_size | Description |
|---|---|---|
| Figurine | small | Small Collectible (5cm) - W:10mm, D:10mm, H:50mm |
| Figurine | standard | Standard Figure (10cm) - W:20mm, D:20mm, H:100mm |
| Figurine | premium | Premium Statue (30cm) - W:30mm, D:30mm, H:300mm |
OneKey Agent Gateway
The Toy Generator APIs are registered under: unique_id: craftsman-agent/craftsman-agent Gateway endpoint:
https://agent.deepnlp.org/agent_router
Set the registered OneKey Gateway access key:
export DEEPNLP_ONEKEY_ROUTER_ACCESS=your_access_key
| Section | Description |
|---|---|
| Craftsman 3D Generator Online | https://craftsman-agent.aiagenta2z.com/app/3d-generator |
| Craftsman Website | https://craftsman-agent.aiagenta2z.com |
| Craftsman App | https://craftsman-agent.aiagenta2z.com/app |
| Craftsman Gallery | https://craftsman-agent.aiagenta2z.com/gallery |
| Craftsman Workspace | https://craftsman-agent.aiagenta2z.com/workspace |
| Craftsman Marketplace | https://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. API: Toy Generator Design Draft
1.1 REST API Requests Usage
toy_generator_design_draft
Generate and design a multi-view toy reference sheet from text prompts and/or source images.
The design draft can be used as the input for the subsequent Toy 3D Model Generation Task.
Requests Input Parameter
| Parameter | Description |
|---|---|
| prompt | Text prompt describing the desired toy |
| images | Array of source image URLs used as visual references |
| asset_size | Toy asset size, such as small, standard, or premium |
| template_id | Toy template such as figurine, stuffed-toy, 3d-printing, game-assets, or architecture |
| provider_model_id | Toy design provider/model identifier; default is supported |
| session_name | Name of the generated workspace session |
| tag_list | Optional tags associated with the generation |
| mode | Generation mode such as demo or basic |
Requests Input Example
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": "toy_generator_design_draft",
"data": {
"prompt": "Stuffed Steve in Minecraft",
"images": [
"https://static.aiagenta2z.com/container/craftsman-agent/default/static/derekzz/a49f905b-4e0d-40c6-af7a-c37be3d1741e/3ccb042bbd9b41c3a9f5d31c564ef4c0.png"
],
"asset_size": "small",
"template_id": "stuffed-toy",
"provider_model_id": "default",
"session_name": "3D Build Plan",
"tag_list": "",
"mode": "demo"
}
}'
Output Keys Definition
| Key | Description |
|---|---|
| success | Whether the design draft generation succeeded |
| blueprint | Toy design blueprint data, when available |
| reference_images | Generated reference image URLs |
| final_image_url | URL of the generated multi-view design sheet |
| overall_image | Object containing individual generated views |
| overall_image.front | Front view image URL |
| overall_image.right | Right view image URL |
| overall_image.back | Back view image URL |
| session_id | Workspace/session identifier |
| title | Generated session title |
| workspace_session_id | Workspace session identifier |
| tag_list | Tags associated with the generation |
Output Example
{
"success": true,
"blueprint": {},
"reference_images": [
"/static/derekzz/1f752866-6757-49e8-ace3-58a0631592f9/2ae7b059979f412ea9b023c741efb3df.png",
"https://us-static.aiagenta2z.com/local/files-wd/onekey_llm_router/e1ea5a81-cd69-4300-8aa5-b2cf682c5c2e.png"
],
"final_image_url": "https://us-static.aiagenta2z.com/local/files-wd/onekey_llm_router/7485ee2a-ae58-48e3-9dc8-eaf1d3d1c4a7.png",
"overall_image": {
"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"
},
"session_id": "45860ee4-dd85-4562-8e51-27232dc9414e",
"title": "3D Build Plan",
"workspace_session_id": "",
"tag_list": ""
}
1.2 CLI Usage
npx onekey agent craftsman-agent/craftsman-agent toy_generator_design_draft '{"prompt":"Stuffed Steve in Minecraft","images":["https://static.aiagenta2z.com/container/craftsman-agent/default/static/derekzz/a49f905b-4e0d-40c6-af7a-c37be3d1741e/3ccb042bbd9b41c3a9f5d31c564ef4c0.png"],"asset_size":"small","template_id":"stuffed-toy","provider_model_id":"default","session_name":"3D Build Plan","tag_list":"","mode":"demo"}'
2. API :Toy Generator 3D Model Task Create
API ID:
toy_generator_task_create
Create a new Toy 3D Model Generation Task from a text prompt, source images, and/or generated multi-view images. The API supports toy-specific templates and 3D generation providers such as Tripo and Meshy.
2.1 REST API Requests Usage
Request Input Parameters
| Parameter | Description |
|---|---|
| prompt | Text prompt describing the desired 3D toy |
| images | Array of source image URLs |
| multi_view | Object containing multi-view image URLs. front is required when using multi-view generation; right and back can be supplied |
| asset_size | Target toy asset size, depending on the selected template |
| template_id | Toy generation template |
| provider_model_id | 3D generation provider, such as tripo/tripo or meshy/meshy |
| model | Optional provider-specific model, such as P1-20260311 or v3.1-20260211 |
| session_name | Name of the generation session |
| tag_list | Optional tags |
| mode | Generation mode such as basic, standard, advanced, or demo |
Request Example
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": "toy_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"
},
"asset_size": "small",
"template_id": "stuffed-toy",
"provider_model_id": "tripo/tripo",
"model": "P1-20260311",
"session_name": "3D Build Plan",
"tag_list": "",
"mode": "basic"
}
}'
Output Keys Definition
| Key | Description |
|---|---|
| provider_model_id | Selected 3D generation provider |
| task_id | Unique ID of the created 3D generation task |
| session_id | Generated workspace/session ID |
| title | Generation session title |
| workspace_session_id | Workspace session ID |
| tag_list | Associated tags |
| final_image_url | Source/final image associated with the task |
| status | Initial task status,e.g. normally running completed |
Output example
{
"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"
}
2.2 CLI Usage
npx onekey agent craftsman-agent/craftsman-agent toy_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"},"asset_size":"small","template_id":"stuffed-toy","provider_model_id":"tripo/tripo","model":"P1-20260311","session_name":"3D Build Plan","tag_list":"","mode":"basic"}'
3. API : Toy Generator 3D Model Task Poll
API ID:
toy_generator_task_poll
Poll the progress and results of a Toy 3D Model Generation Task created by toy_generator_task_create. Continue polling with the returned task_id until the task reaches a terminal status such as success or failed.
Request Input Parameters
| Parameter | Description |
|---|---|
| task_id | The task ID returned by toy_generator_task_create |
| kwargs | Optional generation parameters used when polling |
| kwargs.provider_model_id | Provider model ID, such as tripo/tripo |
| kwargs.mode | Generation mode such as basic |
Request Example
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": "toy_generator_task_poll",
"data": {
"task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
"kwargs": {
"provider_model_id": "tripo/tripo",
"mode": "basic"
}
}
}'
Output Keys Definition
| Key | Description |
|---|---|
| task_id | ID of the Toy 3D Generation Task |
| status | Current task status, such as running or success |
| progress | Generation progress from 0-100 |
| model | Generated 3D model information |
| model.url | Downloadable URL of the generated 3D model |
| model.type | 3D model file type, such as glb |
| preview | Rendered preview information |
| preview.url | URL of the rendered preview |
| preview.type | Preview image type, such as webp |
| metadata | 3D model generation metadata |
| metadata.model_version | Provider model version |
| metadata.texture | Whether textures were generated |
| metadata.pbr | Whether PBR materials were generated |
| metadata.face_limit | Face/polycount limit when available |
| metadata.export_uv | Whether UV coordinates were exported |
| credits | Credits consumed by the generation task |
| raw_output | Original provider generation response when available |
| session_id | Workspace/session ID |
| title | Generation title |
| workspace_session_id | Workspace session ID |
| tag_list | Associated tags |
Running Output Example
{
"task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
"status": "running",
"progress": 81,
"model": {
"url": "",
"type": ""
},
"preview": {
"url": "",
"type": ""
},
"metadata": {
"model_version": "P1-20260311",
"texture": true,
"pbr": true,
"face_limit": null,
"export_uv": true
},
"credits": 50.0,
"raw_output": {
"code": 0,
"status": "success",
"data": {
"type": "multiview_to_model",
"status": "running",
"progress": 81
}
},
"session_id": "",
"title": "",
"workspace_session_id": "",
"tag_list": ""
}
Finished Output Example
{
"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,
"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-af0da0c23ac/legacy_mesh.webp"
},
"task_id": "96b2116e-4b86-4d3c-af04-baf0da0c23ac",
"credits_consumed": 50
}
},
"session_id": "",
"title": "",
"workspace_session_id": "",
"tag_list": ""
}
3.2 CLI Usage
npx onekey agent craftsman-agent/craftsman-agent toy_generator_task_poll '{"task_id":"96b2116e-4b86-4d3c-af04-baf0da0c23ac","kwargs":{"provider_model_id":"tripo/tripo","mode":"basic"}}'