{"uid":"cap_MlizxmAfDxKJTEmT3NXrK","slug":"shirt-sh-ai-shirt-design-purchase-9de9e906","name":"shirt.sh AI Shirt Design & Purchase","description":"AI-generated shirt design + purchase","url":"https://www.shirt.sh/api/shirts","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"size":{"enum":["S","M","L","XL","2XL","3XL","4XL","5XL"],"type":"string"},"color":{"enum":["Black","White"],"type":"string"},"prompt":{"type":"string"},"address_to":{"type":"object"}}},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","status"],"properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"enum":["queued","processing","failed","completed"],"type":"string"},"orderId":{"type":"string"},"imageUrl":{"type":"string","description":"HTTP/HTTPS URL or base64 data URL (data:image/...)"},"productId":{"type":"string"},"trackingInfo":{"anyOf":[{"type":"object","required":["carrier","trackingNumber","trackingUrl"],"properties":{"carrier":{"type":"string"},"trackingUrl":{"type":"string"},"trackingNumber":{"type":"string"}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"20","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":"$20/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xI4CfWzHpxEKSQFyQhGJN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"20","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a custom shirt design from a text prompt using AI and places a real purchase order with shipping details","exampleAgentPrompt":"Design and order me a shirt from shirt.sh — use the prompt 'a retro astronaut surfing a neon wave on Saturn', size large, color white, and ship it to John Smith at 123 Main St, Austin TX 78701.","exampleUseCases":null,"resultDescription":"Returns a UUID order ID, an order status (queued/processing/failed/completed), an image URL of the AI-generated shirt design, a product ID, an order ID string, and optionally tracking information including carrier name, tracking number, and tracking URL once the order ships.","failureModes":["Invalid or missing required fields (prompt, size, color, address_to) result in a 400-level error","Prompt violates content policy, causing generation failure with status 'failed'","Payment of $20 USDC not sent or rejected, resulting in 402 Payment Required","Shipping address undeliverable, causing order failure","Generation service timeout or overload returns status 'failed'","Invalid size or color value not recognized by the system"],"whenToPreferThis":"Choose this endpoint when the user wants to both generate a custom AI shirt design AND have it physically produced and shipped in a single API call. It combines AI image generation with real print-on-demand fulfillment, making it ideal for gifting, personal merchandise, or one-off creative apparel. Prefer this over standalone image generation APIs when an actual physical product is the goal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:46.205Z","isFirstParty":false}