Mint/mcp

mint:generate:start

Upload Reference Image

upload_reference_image

Uploads a reference image you can pass into a model or world generation.

Parameters

Input schema generated from the registry. Required parameters are tagged.

  • source_url

    string (URL)

    Public direct image URL. Simple share pages with public image metadata may also work. This upload-tool field is distinct from start-tool source_url metadata.

  • base64_data

    string

    Raw base64 image bytes or a data:image/*;base64 URL. Prefer source_url when possible.

  • file_name

    string

  • content_type

    "image/jpeg" | "image/png" | "image/gif" | "image/webp"

  • name

    string

  • contextrequired

    string

    Describe the user's goal and why this tool helps in 15-25 words. Do not include credentials, personal data, identifiers, URLs, emails, or account addresses.

Example request

{
  "source_url": "https://example.com/sketches/couch-sketch.jpg",
  "name": "Couch sketch"
}

Example response

{
  "imageUrl": "https://cdn.mint.gg/refs/couch-sketch-abc123.jpg",
  "cdnUrl": "https://cdn.mint.gg/refs/couch-sketch-abc123.jpg",
  "fileName": "couch-sketch.jpg",
  "contentType": "image/jpeg",
  "sizeBytes": 184320,
  "prefix": "refs/"
}

Use cases

  • Upload an image once and reuse it across multiple generations.
  • Turn a base64 image into a stable Mint URL.
Previous← get_asset_artifactNextstart_world_generation →