# The Agents Gift Shop — Design from Image

> The Agents Gift Shop — Design from Image is a paid API for AI agents from www.theagentsgiftshop.com, paid per call via x402, $2/call, status unknown (last checked 2026-10-23).

Accepts an uploaded image (or URL) and generates restyled artwork plus mockups for a chosen print-on-demand product, queuing a fulfillment job paid via x402 USDC.

## Facts

- Endpoint: POST https://www.theagentsgiftshop.com/v1/designs/from-image?utm_source=zero.xyz
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/the-agents-gift-shop-design-from-image-c15d17a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y96f7wkmiGlYH9-jO-H_J

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability the-agents-gift-shop-design-from-image-c15d17a4 -d '<json body>'
```

Example prompt: Take this image of my dog — https://example.com/mydog.jpg — and restyle it in a 'watercolor, pastel' style, then create a shirt design from it using The Agents Gift Shop.

## When to prefer this

Choose this endpoint when you have an existing image (photo, logo, illustration) that you want artistically restyled and placed onto a specific merchandise product. Use it instead of the text-prompt design endpoint when you have a concrete visual starting point rather than a pure text description. Ideal for agents automating branded merchandise creation, fan art printing, or pet/portrait merch workflows.

## Known failure modes

- Image URL unreachable or returns non-image content — 400 or timeout
- Image exceeds 10 MB or pixel bounds (outside 100–10000 px) — validation error
- Unsupported product_type value not in catalog enum — 422 unprocessable
- Payment failure via x402 (insufficient USDC balance or wrong chain) — 402 Payment Required
- Design generation timeout or backend failure — 500 with no poll URL
- design_key not saved by caller — no way to authenticate follow-up requests

## How this service works

Custom print-on-demand merchandise for autonomous agents, paid per call with x402 (USDC on Base). Describe a design, get artwork and mockups, order it printed and shipped.

## Output

Returns a JSON object with a design_id (UUID), a one-time design_key (sent as X-Design-Key header for subsequent requests), a poll URL to check job status, the product_type selected, price_cents (e.g. 2500 for $25), and an initial status of 'queued'. The agent must poll the returned URL to retrieve final artwork and mockup images once processing completes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "style": {
   "type": "string",
   "maxLength": 300,
   "description": "Optional style keywords for the restyle, e.g. 'watercolor, pastel'"
  },
  "image_url": {
   "type": "string",
   "format": "uri",
   "description": "Public https URL of a PNG/JPEG/WEBP (≤10 MB, 100–10000 px)"
  },
  "is_public": {
   "type": "boolean",
   "default": false
  },
  "image_base64": {
   "type": "string",
   "description": "Alternative to image_url: base64 (or data: URI) of the image"
  },
  "product_type": {
   "enum": [
    "shirts",
    "sweaters",
    "stickers",
    "tote bags",
    "long sleeve",
    "mugs",
    "puzzles",
    "hats",
    "phone cases",
    "blankets"
   ],
   "type": "string",
   "description": "One of the catalog product types (GET /v1/catalog/products). Premium types add $1.00."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "poll": "/v1/designs/5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b",
  "schema": "tags_v1",
  "status": "queued",
  "design_id": "5d1d7a2e-5c8f-4c3a-9f0e-2c3d4e5f6a7b",
  "design_key": "dk_…(shown once; send as X-Design-Key)",
  "price_cents": 2500,
  "product_type": "shirts"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-agents-gift-shop-design-from-image-c15d17a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.theagentsgiftshop.com](https://www.zero.xyz/host/www.theagentsgiftshop.com/llms.txt)