---
title: "mockup_image tool call"
method: POST
path: "/api/tools/mockup_image"
tags: ["Tools"]
---

# mockup_image tool call

`POST /api/tools/mockup_image`

## Request

- Base URL: `https://studiomcphub.com`
- URL: `https://studiomcphub.com/api/tools/mockup_image`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Stripe-Payment-Intent`

Cost: 1 GCX ($0.10). Payment: GCX credits (Bearer token) or Stripe (X-Stripe-Payment-Intent header).

## Request body

- object
  - `background_color` string: Background hex color
  - `image` string, required: Base64-encoded design image
  - `product` 'tshirt' | 'poster' | 'canvas' | 'phone_case' | 'mug' | 'tote_bag': Product type

## Response `200`

Tool result

## Other responses

- `402`: Payment required — returns GCX credit info and Stripe checkout link

---

[API](https://skmtc.dev/studiomcphub/apis/studiomcphub-api.md) · [All operations](https://skmtc.dev/studiomcphub/apis/studiomcphub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/studiomcphub/apis/studiomcphub-api/revisions/15995bc5ee2e?raw)