> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mediamonster.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Product card from a photo

> A clean packshot on a card with its name, price and stars

`POST /api/v1/runs` with `"recipe": "product-card-from-a-photo"` · MCP `run_recipe`

A clean packshot on a card with its name, price and stars

> [!NOTE]
>
> The product is redrawn, not retouched — check the label before you post.

## What it does

* **Takes:** a picture.
* **Makes:** a picture.
* **Price:** 21 credits per file. Steps below one that makes several files run once on each, so a dry run is the exact figure.

## The steps

Run top to bottom; each step is handed what the step above made.

> [card] [1. Packshot](https://docs.mediamonster.app/skills/reference/packshot.md)
>
> `packshot`

> [card] [2. Fill a template](https://docs.mediamonster.app/skills/reference/fill-template.md)
>
> `fill-template`

| # | Step | Tool | Settings |
| - | - | - | - |
| 1 | [Packshot](https://docs.mediamonster.app/skills/reference/packshot.md) | `packshot` | defaults |
| 2 | [Fill a template](https://docs.mediamonster.app/skills/reference/fill-template.md) | `fill-template` | `template: product-card`, `name: \{\{name\}\}`, `price: \{\{price\}\}`, `stars: \{\{stars\}\}`, `reviews: \{\{reviews\}\}` |

## Inputs

Send these as `inputs` on the run. Each `{{name}}` in the steps above is filled with its value.

| Input | Kind | Required | Default |
| - | - | - | - |
| `name` | text | yes | — |
| `price` | text | yes | — |
| `stars` | number | yes | — |
| `reviews` | text | yes | — |

## Run it

Run it by name and you get the recipe as it is today. To change a setting, send the `steps` from `GET /api/v1/recipes/product-card-from-a-photo` with your edits instead. Add `dry_run=true` to price it first.

```bash curl theme={"theme":{"light":"github-dark","dark":"github-dark"}}
# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
curl https://mediamonster.app/api/v1/runs \
  -H "Authorization: Bearer $MEDIAMONSTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "recipe": "product-card-from-a-photo",
  "url": "https://example.com/photo.jpg",
  "inputs": {
    "name": "<product name>",
    "price": "<price>",
    "stars": "1",
    "reviews": "<review count>"
  }
}'
```

```typescript TypeScript (fetch) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
// Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
const res = await fetch("https://mediamonster.app/api/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MEDIAMONSTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    recipe: "product-card-from-a-photo",
    url: "https://example.com/photo.jpg",
    inputs: {
      name: "<product name>",
      price: "<price>",
      stars: "1",
      reviews: "<review count>",
    },
  }),
});
const run = await res.json();
console.log(run);
```

```typescript TypeScript (SDK) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
import { Mediamonster } from "@mediamonster/sdk";

// Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
const mm = new Mediamonster({ apiKey: process.env.MEDIAMONSTER_API_KEY });

const run = await mm.recipes.run("product-card-from-a-photo", {
  url: "https://example.com/photo.jpg",
  inputs: {
    name: "<product name>",
    price: "<price>",
    stars: "1",
    reviews: "<review count>",
  },
});
console.log(run);
```

```python Python (requests) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
import os

import requests

# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
res = requests.post(
    "https://mediamonster.app/api/v1/runs",
    headers={"Authorization": f"Bearer {os.environ['MEDIAMONSTER_API_KEY']}"},
    json={
        "recipe": "product-card-from-a-photo",
        "url": "https://example.com/photo.jpg",
        "inputs": {
            "name": "<product name>",
            "price": "<price>",
            "stars": "1",
            "reviews": "<review count>",
        },
    },
)
print(res.json())
```

```python Python (SDK) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
from mediamonster import Mediamonster

# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
# Reads MEDIAMONSTER_API_KEY from the environment.
mm = Mediamonster()

run = mm.recipes.run(
    "product-card-from-a-photo",
    url="https://example.com/photo.jpg",
    inputs={
        "name": "<product name>",
        "price": "<price>",
        "stars": "1",
        "reviews": "<review count>",
    },
)
print(run)
```

```json MCP theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "name": "run_recipe",
  "arguments": {
    "recipe": "product-card-from-a-photo",
    "url": "https://example.com/photo.jpg",
    "inputs": {
      "name": "<product name>",
      "price": "<price>",
      "stars": "1",
      "reviews": "<review count>"
    }
  }
}
```

## See also

* [`GET /api/v1/recipes/product-card-from-a-photo`](https://mediamonster.app/api/v1/recipes/product-card-from-a-photo) — this recipe live
* [Product card from a photo in the app](https://mediamonster.app/recipes/product-card-from-a-photo)
* [Recipes over the API](https://docs.mediamonster.app/api/runs.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.