Tools / Jewelry Visualizer

Generate Jewelry

Generate a photorealistic image of jewelry from a text description, reference images, or both. Describe the piece and/or provide reference photos for inspiration. Optionally specify a model/person (via text or photo) to show the jewelry worn.

Returns: Photorealistic jewelry image with permanent URL and shareable download page

Parameters

prompt *stringJewelry description: type, metal, stones, style, details. Combine with reference_images for accuracy.

reference_imagesarrayURLs of reference images (sketches, photos, mood boards). Server CAN fetch any public URL.

model_descriptionstringDescribe person to wear the jewelry: skin tone, outfit, pose. Omit for standalone product shot.

model_image_urlstringURL of person/model photo to show wearing the jewelry. Server CAN fetch any public URL.

shot_typestringproduct: studio shot. lifestyle: real-world. close_up: macro. editorial: fashion. Auto-detects from inputs.

aspect_ratiostringAspect ratio for the output image. Defaults to 1:1 (square) for product shots, 3:4 for model shots.

num_imagesnumberNumber of images to generate (1-4). Defaults to 1.

seednumberRandom seed for reproducible results.

Example

Generate ring from text description only

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "generate_jewelry",
  "input": {
    "prompt": "Engagement ring, 18k yellow gold band, emerald-cut 2 carat diamond center stone, pavé set round brilliant diamonds on the band, polished finish"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Visualize on Model

Take a reference photo of existing jewelry and render it on a person or model. Accepts the jewelry image URL plus a text description and/or a photo of the model/person. Describe where it is worn (hand, neck, ear, wrist) and the desired scene.

Returns: Visualization of reference jewelry on a model with permanent URL and shareable download page

Parameters

jewelry_image_url *stringURL of the jewelry reference image. Server CAN fetch any public URL. Use a clear, well-lit photo.

prompt *stringWhere jewelry is worn (hand, neck, wrist), model description (skin tone, outfit), and scene.

model_image_urlstringURL of person/model photo to wear the jewelry. Server CAN fetch any public URL.

aspect_ratiostringAspect ratio for the output image. Defaults to 1:1 (square) for product shots, 3:4 for model shots.

seednumberRandom seed for reproducible results.

Example

Show ring on a described model hand

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "visualize_on_model",
  "input": {
    "jewelry_image_url": "https://example.com/ring.jpg",
    "prompt": "Show this engagement ring on a woman's left hand ring finger, light skin tone, hand resting on a linen tablecloth, soft natural daylight"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Design to Schematic

Convert a jewelry design or photo into a technical schematic illustration. Produces clean line-art engineering drawings showing stone settings, metal structure, and construction details. Accepts a reference image, text description, or both.

Returns: Technical schematic line-art illustration of the jewelry piece

Parameters

design_image_urlstringURL of the jewelry reference image (photo or sketch). Server CAN fetch any public URL.

promptstringDescribe the jewelry piece. Use alone or with design_image_url to refine the schematic.

viewstringfront: primary face. side: profile/cross-section. top: plan view. exploded: assembly. all: three-view orthographic.

stylestringblueprint: white lines on navy. line_drawing: black-on-white sketch. technical: with dimension arrows. cad: sterile CAD output.

aspect_ratiostringAspect ratio for the output image. Defaults to 1:1 (square) for product shots, 3:4 for model shots.

seednumberRandom seed for reproducible results.

Example

Convert a ring photo to a front-view technical schematic

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "design_to_schematic",
  "input": {
    "design_image_url": "https://example.com/ring.jpg",
    "view": "front",
    "style": "line_drawing"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Recolor Design

Swap the metal color and/or stone type on an existing jewelry photo. Changes yellow → rose gold, diamonds → sapphires, etc. Preserves all design details exactly.

Returns: Recolored jewelry photo with only the specified material changes, preserving all design details

Parameters

jewelry_image_url *stringURL of the jewelry photo to recolor. Server CAN fetch any public URL.

metalstringNew metal to apply. Omit to keep metal unchanged.

stone_typestringReplace all stones with this type (e.g. sapphire, ruby, emerald, moissanite).

stone_colorstringChange stone color (e.g. deep blue, vivid red). Use with or without stone_type.

promptstringAdditional change instructions not covered by metal/stone fields.

aspect_ratiostringAspect ratio for the output image. Defaults to 1:1 (square) for product shots, 3:4 for model shots.

seednumberRandom seed for reproducible results.

Example

Change yellow gold ring to rose gold

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "recolor_design",
  "input": {
    "jewelry_image_url": "https://example.com/ring.jpg",
    "metal": "rose_gold"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Engrave Preview

Add engraved text to a jewelry photo — ring bands, pendants, or bracelets. Shows how a personalized inscription will look before ordering.

Returns: Jewelry photo with engraved inscription rendered realistically in the metal

Parameters

jewelry_image_url *stringURL of the jewelry photo. Server CAN fetch any public URL.

text *stringThe exact text to engrave (name, date, initials, phrase).

placementstringinside_band: inner ring circumference. outside_band/ring_shank: outer surface. front_surface/pendant_back: face or reverse.

font_stylestringscript: cursive. block: bold sans-serif. roman: classic serif. diamond_cut: faceted V-cut grooves.

promptstringExtra engraving instructions (position, size, orientation).

aspect_ratiostringAspect ratio for the output image. Defaults to 1:1 (square) for product shots, 3:4 for model shots.

seednumberRandom seed for reproducible results.

Example

Preview wedding date engraving inside a ring band

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "engrave_preview",
  "input": {
    "jewelry_image_url": "https://example.com/wedding-band.jpg",
    "text": "14.06.2026",
    "placement": "inside_band",
    "font_style": "roman"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Compare Variants

Generate the same jewelry design in multiple metal/stone combinations side by side. Useful for client proposals and purchasing decisions.

Returns: Gallery of variant images with labels — one image per material/stone combination

Parameters

promptstringBase jewelry description. Used for text-to-image when no base_image_url provided.

base_image_urlstringReference photo of the piece to recolor into variants. Server CAN fetch any public URL.

variants *arrayUp to 4 variants to generate. Each needs a label and optional metal/stone/details.

shot_typestringproduct: studio shot. lifestyle: natural setting. editorial: fashion.

aspect_ratiostringAspect ratio for the output image. Defaults to 1:1 (square) for product shots, 3:4 for model shots.

seednumberRandom seed. Same seed keeps composition consistent across variants.

Example

Compare an engagement ring in 3 metal options from a reference photo

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "compare_variants",
  "input": {
    "base_image_url": "https://example.com/ring.jpg",
    "variants": [
      {
        "label": "Yellow Gold",
        "metal": "yellow gold"
      },
      {
        "label": "Rose Gold",
        "metal": "rose gold"
      },
      {
        "label": "Platinum",
        "metal": "platinum"
      }
    ],
    "shot_type": "product"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Clean Photo

Remove dust, fingerprints, and surface marks from a jewelry product photo. Produces a clean studio shot without touching the jewelry itself.

Returns: Cleaned jewelry photo with dust and marks removed, jewelry itself unchanged

Parameters

jewelry_image_url *stringURL of the jewelry product photo to clean. Server CAN fetch any public URL.

promptstringSpecific issues to fix (e.g. "heavy fingerprint on left side of velvet pad").

aspect_ratiostringAspect ratio for the output image. Defaults to 1:1 (square) for product shots, 3:4 for model shots.

seednumberRandom seed for reproducible results.

Example

Clean dust and fingerprints from a ring product shot

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "clean_photo",
  "input": {
    "jewelry_image_url": "https://example.com/dusty-ring.jpg"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Identify Piece

Analyze a jewelry photo and identify the piece's era, style, likely metal, stone types, setting, and condition. Returns structured data suitable for appraisal, cataloging, or client reports.

Returns: Structured expert analysis of the jewelry piece including period, metal, stones, and condition

Parameters

image_url *stringURL of the jewelry photo to analyze. Clear, well-lit photos give best results.

questionsstringOptional specific questions to answer (e.g. "Is this Art Deco? What karat is the gold?").

Example

Identify an unknown ring from a photo

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "identify_piece",
  "input": {
    "image_url": "https://example.com/mystery-ring.jpg"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Identify Hallmark

Read and decode jewelry hallmarks or maker's marks from a close-up photo. Returns metal purity, assay office, date letter, maker's mark, and country of origin.

Returns: Decoded hallmark data including metal purity, origin, date, and assay office

Parameters

image_url *stringClose-up photo of the hallmark or stamp. Macro/zoomed-in shots work best.

country_hintstringOptional country hint to narrow down hallmarking system (e.g. "United Kingdom", "France").

Example

Decode British hallmarks on a silver piece

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "jewelry-visualizer",
  "skill": "identify_hallmark",
  "input": {
    "image_url": "https://example.com/hallmark-closeup.jpg",
    "country_hint": "United Kingdom"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"jewelry-visualizer","skill":"generate_jewelry","input":{}}' \
  https://api.toolrouter.com/v1/tools/call