AI Hat / Cap Designer Skills from Craftsman Agent

Agentic AI Clothing Designer generates customized clothing designs for print, personalization, prototyping, and manufacturing. It supports T-Shirts, Shirts, Polo Shirts, Hoodies / Sweatshirts, Jackets, Coats, Dresses, Skirts, Pants / Trousers, Jeans, Shorts, Hats / Caps, Scarves, Gloves, and Socks.

The designer can use natural-language prompts, structured clothing parameters, and reference images to generate customized designs with materials, fits, silhouettes, dimensions, closures, decorations, prints, text, logos, and other design details.

The design workflow can generate:

• Clothing design concepts
• Customized text and logo placement
• Reference-image-based designs
• Multi-view design sheets
• Interactive 3D clothing viewers
• Final 3D design assets when available
• Manufacturing-on-demand designs

After the design, you can also use the Craftsman Agent Manufacturing Platform to find suppliers of Craftsman of all kinds.

https://craftsman-agent.aiagenta2z.com/app/clothing-designer/hat

The typical Clothing designer workflow such as T-Shirt POD include:

[Text/Image Prompt of your Clothing Type, Texture, ]
        ->
[Define Customized Text or Logo Printing, Dimensions]
        ->
[Generate 3D Interactive Viewer] or [Generate final 3D Models.g. ]        
        ->
[Generate Preview Images From Multiple Views]
        ->
[Manufacturing on Demand Send Designs to Factory]

OneKey Agent Gateway

The Bag Designer 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

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

Prompt Examples:

Template ID: t-shirt

Prompt: Design an white T-shirt graphic tee made of cotton. The front prints 'Craftsman' and the logo of Craftsman Agent.

Template ID: shirt

Prompt: Create a slim fit casual shirt using linen material.

Template ID: polo-shirt

Prompt: A regular fit pique polo shirt with a ribbed collar.

Template ID: hoodie

Prompt: Design a relaxed fit fleece pullover hoodie sweater. The front prints 'Craftsman' and the logo of Craftsman Agent.

Template ID: jacket

Prompt: Create a regular fit leather bomber jacket.

Template ID: coat

Prompt: Design a long wool trench coat.

Template ID: dress

Prompt: Create an A-line maxi dress made of silk.

Template ID: skirt

Prompt: Design a high-waisted pleated skirt made of polyester.

Template ID: pants

Prompt: Tailored fit chinos made from a cotton blend.

Template ID: jeans

Prompt: Design a pair of mid-rise skinny jeans in denim.

Template ID: shorts

Prompt: Loose fit nylon board shorts.

Template ID: hat

Prompt: A felt fedora hat with a teardrop crown.

Template ID: scarf

Prompt: Design a cashmere infinity loop scarf.

Template ID: gloves

Prompt: Full-finger leather winter gloves.

Template ID: socks

Prompt: Athletic cotton socks with a ribbed cuff.

1. API: Clothing Designer Design Draft

1.1 REST API Requests Usage

clothing_generator_design_draft

Generate a clothing design draft with an interactive 3D model and multi-view images from:

• User text prompts
• Reference images
• Structured clothing parameters
• Clothing template IDs
• Customized print, text, logo, and decoration requirements

The resulting design draft can contain an online interactive 3D model viewer for future modification.

Requests Input Parameter

Input Parameter Options

template_id: The template reference model to generate

Supported Jewelry Category Template IDs

Supported template_id include

Always use the exact template ID when constructing a request.

mode: The mode as complexity of design for each generation task

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 '{
      "prompt": "A felt fedora hat with a teardrop crown.",
      "images": [],
      "template_id": "hat",
      "provider_model_id": "default",
      "options": {},
      "session_name": "Craftsman Hat / Cap",
      "tag_list": "t-shirt,graphic,pod",
      "mode": "demo"
    }
  }'

This example use the 'demo' mode for debug purpose, for real example, please use 'basic' instead.

Output Keys Definition

Output Example

{
  "success": true,
  "blueprint": {},
  "reference_images": [],
  "final_image_url": "",
  "overall_image": {},
  "session_id": "31d57eb9-9a37-4808-9c5b-1bfbb2abf5fb",
  "title": "T-Shirt Designer",
  "workspace_session_id": "",
  "tag_list": "t-shirt,graphic,pod",
  "options": {
    "gender": "unisex",
    "sub_category": "graphic",
    "material": "cotton",
    "asset_size": "m",
    "fit": "regular",
    "neckline": "crew",
    "sleeve": "short",
    "length": "hip",
    "hem_style": "straight"
  },
  "prompt": "Design a white cotton graphic T-shirt with a regular fit.",
  "share_url": "https://craftsman-agent.aiagenta2z.com/app/sessions/share/31d57eb9-9a37-4808-9c5b-1bfbb2abf5fb?pwd=de06"
}

Note: share_url: After the Jewelry Design generation task finished, a share_url value contains URL of the canvas workspace will be returned. This is the website to view the progress of the generation and the multiview sheets, the front view, side view, backview. Please notify user the share_url link to view the Jewelry Design generation task status and results online!

1.2 CLI Usage

npx onekey agent craftsman-agent/craftsman-agent clothing_generator_design_draft '{"prompt":"Design a white cotton graphic T-shirt with a regular fit. Print text CRAFTSMAN and the Craftsman Agent logo on the front.","images":[],"template_id":"t-shirt","provider_model_id":"default","options":{"gender":"unisex","sub_category":"graphic","material":"cotton","asset_size":"m","fit":"regular","neckline":"crew","sleeve":"short","length":"hip","hem_style":"straight"},"session_name":"Craftsman Graphic T-Shirt","tag_list":"t-shirt,graphic,pod","mode":"demo"}'

Note: demo mode will return demo results for debug purpose, when production, change to 'basic' or other modes.

1.3 Detailed Clothing Designer Options

1.3.1 T-Shirt

template_id: t-shirt

Main Parameters

White T-Shirt with Customizable Text Fonts and Colors on the T-Shirt and Picture

Other Parameters / Defaults

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "sub_category": "basic",
  "material": "cotton",
  "asset_size": "m",
  "fit": "regular",
  "neckline": "crew",
  "sleeve": "short",
  "length": "hip",
  "hem_style": "straight"
}

1.3.2 Shirt

template_id: shirt

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "sub_category": "casual-shirt",
  "material": "linen",
  "asset_size": "m",
  "fit": "slim",
  "collar": "point",
  "sleeve": "long",
  "closure": "buttons",
  "pocket": "none",
  "cuff": "standard"
}

1.3.3 Polo Shirt

template_id: polo-shirt

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "material": "pique-cotton",
  "asset_size": "m",
  "fit": "regular",
  "collar": "classic",
  "placket": "two-button",
  "sleeve": "short",
  "details": "logo"
}

1.3.4 Hoodie / Sweatshirt

template_id: hoodie

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "material": "fleece",
  "asset_size": "m",
  "sub_category": "pullover",
  "fit": "relaxed",
  "hood": "standard",
  "pocket": "kangaroo",
  "cuff": "ribbed"
}

1.3.5 Jacket

template_id: jacket

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "material": "leather",
  "asset_size": "m",
  "sub_category": "bomber",
  "fit": "regular",
  "length": "waist",
  "collar": "bomber",
  "closure": "zipper",
  "pockets": "side"
}

1.3.6 Coat

template_id: coat

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "material": "wool",
  "asset_size": "m",
  "sub_category": "trench",
  "length": "full",
  "fit": "regular",
  "collar": "lapel",
  "closure": "belt",
  "lining": "polyester"
}

1.3.7 Dress

template_id: dress

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "female",
  "material": "silk",
  "asset_size": "m",
  "sub_category": "maxi",
  "silhouette": "a-line",
  "neckline": "v-neck",
  "sleeve": "sleeveless",
  "waist": "natural",
  "skirt": "flared",
  "details": "draping"
}

1.3.8 Skirt

template_id: skirt

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "female",
  "sub_category": "pleated",
  "material": "polyester",
  "asset_size": "m",
  "waist": "high-rise",
  "silhouette": "a-line",
  "length": "midi",
  "closure": "zipper",
  "details": "pleats"
}

1.3.9 Pants / Trousers

template_id: pants

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "sub_category": "straight",
  "material": "cotton-blend",
  "asset_size": "32",
  "fit": "regular",
  "rise": "mid",
  "leg": "straight",
  "length": "full",
  "waist": "button",
  "details": "pockets"
}

##1.3.10 Jeans

template_id: jeans

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "sub_category": "slim",
  "material": "stretch-denim",
  "asset_size": "32",
  "rise": "mid",
  "wash": "medium",
  "distressing": "light",
  "stretch": "low",
  "details": "contrast-stitch",
  "denim_weight": "medium",
  "thread_color": "orange",
  "button_type": "metal",
  "wash_process": "stone"
}

##1.3.11 Shorts

template_id: shorts

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "material": "cotton",
  "asset_size": "m",
  "sub_category": "casual",
  "fit": "relaxed",
  "rise": "mid",
  "length": "mid",
  "closure": "drawstring",
  "details": "pockets"
}

1.3.12 Hat / Cap

template_id: hat

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "sub_category": "baseball",
  "material": "cotton",
  "asset_size": "medium",
  "crown": "mid",
  "brim": "curved",
  "closure": "snapback",
  "decoration": "embroidery"
}

1.3.13 Scarf

template_id: scarf

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "material": "cashmere",
  "asset_size": "medium",
  "sub_category": "fashion",
  "shape": "rectangular",
  "length": "medium",
  "width": "standard",
  "edge": "fringe",
  "pattern": "solid"
}

1.3.14 Gloves

template_id: gloves

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "material": "wool",
  "asset_size": "m",
  "sub_category": "winter",
  "finger": "full",
  "length": "wrist",
  "cuff": "ribbed",
  "details": "logo"
}

##1.3.15 Socks

template_id: socks

Main Parameters

Asset Size Metadata

Example options

{
  "gender": "unisex",
  "sub_category": "athletic",
  "material": "cotton",
  "asset_size": "m",
  "cuff": "ribbed",
  "toe": "reinforced",
  "design": "logo",
  "cushion": "medium"
}

7. Clothing Design Parameter Rules

1. Always use the exact template_id from the supported Clothing Designer template list.
2. Always use the exact option IDs listed for the selected template.
3. Do not use display names such as Cotton, Regular, Slim Fit, or Graphic T-Shirt as structured option values; use IDs such as cotton, regular, slim-fit, and graphic.
4. Only pass parameters explicitly defined by the selected clothing template.
5. Do not pass parameters from another clothing template.
6. asset_size values must use the exact supported IDs for the selected template.
7. Size metadata such as chest, waist, bust, hip, hand circumference, foot length, or head circumference is descriptive metadata and should not replace the corresponding asset_size ID.
8. Scalar dimensions and customization values can be included when supported by the API or described in prompt.
9. When a user gives natural-language requirements, map requirements to the closest supported IDs.
10. Preserve design details that cannot be represented by structured options in prompt.
11. Reference images should be passed through images.
12. Use prompt to describe material appearance, texture, construction, silhouette, printing, embroidery, logo placement, color, artwork, decoration, and manufacturing intent when no dedicated structured parameter exists.
13. For customized text or logo printing, specify the exact text, logo, placement, color, scale, and orientation in prompt.
14. For POD designs, describe the printable artwork and placement clearly.
15. For MOD designs, describe construction, material, finishing, dimensions, and manufacturing requirements clearly.
16. If the user specifies a parameter value that is not supported, choose the closest supported ID and preserve the original requirement in prompt.
17. Do not invent unsupported option IDs.
18. Keep options limited to structured parameters relevant to the selected template_id.
19. Use provider_model_id: "default" unless a specific supported provider/model is requested.
20. Use mode: "basic", "standard", or "advanced" for actual generation. Use "demo" only for debug or predefined-result testing.
21. When generation returns share_url, provide the URL to the user so they can view the Clothing Designer workspace and generated results online.
22. The generated design may include an interactive 3D model, multi-view images, front view, back view, side view, and other available design assets.

8. Natural Language to Structured Options

When a user says:

Create a relaxed oversized black cotton T-shirt for men.

Map it to:

{
  "gender": "male",
  "sub_category": "basic",
  "material": "cotton",
  "asset_size": "default",
  "fit": "oversized"
}

and preserve the color requirement in the prompt:

Create a black oversized cotton T-shirt for men.

When a user says:

Make a long cashmere scarf with fringed edges.

Map it to:

{
  "gender": "unisex",
  "material": "cashmere",
  "asset_size": "long",
  "length": "long",
  "edge": "fringe"
}

When a user says:

Create a slim mid-rise pair of blue jeans with light distressing.

Map it to:

{
  "gender": "unisex",
  "sub_category": "slim",
  "material": "default",
  "asset_size": "default",
  "rise": "mid",
  "wash": "medium",
  "distressing": "light"
}

The exact color or visual appearance can remain in prompt if it is not represented by a structured parameter.

9. Custom Printing and Personalization

Clothing designs can contain customized:

• Text
• Logos
• Artwork
• Graphics
• Embroidery
• Patches
• Labels
• Character graphics
• Brand marks
• Front prints
• Back prints
• Placement-specific decoration

For example:

Design a white cotton graphic T-shirt with a regular fit.
Place the text "AI Agent A2Z" centered on the front in dark green.
Add the Craftsman Agent logo underneath the text.
Use a clean premium streetwear aesthetic.

When a structured parameter is not available for a specific print or personalization requirement, keep the structured clothing configuration in options and describe the exact customization in prompt.

10. Reference Images

Reference images can be supplied through:

{
  "images": [
    "https://example.com/reference-front.jpg",
    "https://example.com/reference-material.jpg"
  ]
}

Use the prompt to explain how the references should influence the generated design.

For example:

Use the first image as the silhouette reference and the second
image as the material and texture reference. Preserve the overall
construction while changing the garment to an oversized cotton
T-shirt with a black base color and customized front typography.

11. Design Generation Guidelines

The Clothing Designer should:

• Select the correct clothing template_id.
• Map natural language to supported option IDs.
• Keep structured parameters inside options.
• Keep free-form visual and manufacturing requirements inside prompt.
• Use reference images when supplied.
• Generate designs appropriate for the selected clothing category.
• Preserve requested dimensions and size information.
• Preserve requested material and texture.
• Preserve fit and silhouette.
• Preserve closure and construction details.
• Preserve printing, embroidery, logo, and decoration requirements.
• Generate multi-view references when available.
• Return the generated workspace through share_url when available.

The API should not assume that a parameter available for one clothing category is available for another category.

12. Example Complete Request

{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "clothing_generator_design_draft",
  "data": {
    "prompt": "Design a premium oversized cotton graphic T-shirt for a unisex streetwear collection. Use a black base color. Print 'AI Agent A2Z' centered on the front in a clean modern style and place the Craftsman Agent logo underneath. Generate a professional multi-view product design suitable for POD.",
    "images": [],
    "template_id": "t-shirt",
    "provider_model_id": "default",
    "options": {
      "gender": "unisex",
      "sub_category": "graphic",
      "material": "cotton",
      "asset_size": "m",
      "fit": "oversized",
      "neckline": "crew",
      "sleeve": "short",
      "length": "hip",
      "hem_style": "straight"
    },
    "session_name": "AI Agent A2Z Graphic T-Shirt",
    "tag_list": "t-shirt,graphic,streetwear,pod",
    "mode": "basic"
  }
}

13. Important API Naming

The Clothing Designer API is:

clothing_generator_design_draft

The OneKey Agent is:

craftsman-agent/craftsman-agent

The gateway is:

https://agent.deepnlp.org/agent_router

The primary Clothing Designer application is:

https://craftsman-agent.aiagenta2z.com/app/clothing-designer

Use these identifiers consistently when constructing API and CLI requests.