{"uid":"cap_y96f7wkmiGlYH9-jO-H_J","slug":"the-agents-gift-shop-design-from-image-c15d17a4","name":"The Agents Gift Shop — Design from Image","description":"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.","url":"https://www.theagentsgiftshop.com/v1/designs/from-image?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0EI4hZMQ0qGIogcYXWG_8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Custom pet merch from photo","prompt":"I have a photo of my cat at https://example.com/whiskers.jpg — can you restyle it as a vintage illustration and put it on a tote bag for me?"},{"title":"Brand logo on premium mug","prompt":"Here's my coffee shop logo at https://mybrand.com/logo.png — restyle it with bold, graphic art vibes and generate a mug design from it."},{"title":"Fan art sticker from uploaded image","prompt":"Use this fan art image I drew — https://mysite.com/fanart.webp — and turn it into a sticker design with a comic book style."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T14:05:47.868Z","isFirstParty":false,"canonicalSlug":"the-agents-gift-shop-design-from-image-c15d17a4"}