{"openapi":"3.1.0","info":{"title":"AssetForge","version":"0.2.0","description":"Agent-native asset API. Pay with x402 USDC on Base or prepaid credits (API key). Models via Workers AI + AI Gateway BYOK.","contact":{"url":"https://assetforge.happywebs.workers.dev"},"license":{"name":"Commercial licence","url":"https://assetforge.happywebs.workers.dev/licence"}},"servers":[{"url":"https://assetforge.happywebs.workers.dev"}],"paths":{"/health":{"get":{"operationId":"health","summary":"Liveness","responses":{"200":{"description":"OK"}}}},"/v1/catalogue":{"get":{"operationId":"getCatalogue","summary":"List SKUs and prices (free)","responses":{"200":{"description":"Catalogue"}}}},"/v1/jobs/{id}":{"get":{"operationId":"getJob","summary":"Poll async job (video)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job status"},"404":{"description":"Not found"}}}},"/v1/credits/checkout":{"post":{"operationId":"createCreditCheckout","summary":"Stripe Checkout for credit packs (Bearer API key)","responses":{"200":{"description":"Checkout URL"}}}},"/v1/images":{"post":{"operationId":"generate_placeholder_image","summary":"Photographic or illustrative placeholder image from a text prompt. Returns a hosted PNG URL. Cost: $0.08 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"0.08","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","maxLength":500},"width":{"type":"integer","default":1200},"height":{"type":"integer","default":630},"format":{"type":"string","enum":["png","webp"]}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/logos":{"post":{"operationId":"generate_logo","summary":"Vector logo mark from business name + style. Returns SVG and PNG. Prefers Recraft when BYOK key set; else Workers AI. Cost: $1.20 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"1.20","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["businessName","styleDescription"],"properties":{"businessName":{"type":"string"},"styleDescription":{"type":"string"},"includeWordmark":{"type":"boolean","default":true}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/favicons":{"post":{"operationId":"generate_favicon_set","summary":"Complete favicon set + HTML link block from description or logo URL. Cost: $0.75 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"0.75","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string"},"logoUrl":{"type":"string","format":"uri"},"brandColor":{"type":"string"}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/og-images":{"post":{"operationId":"generate_og_image","summary":"1200×630 Open Graph image with optional title/subtitle. Cost: $0.10 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"0.10","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string"}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/voiceovers":{"post":{"operationId":"generate_voiceover","summary":"Text-to-speech audio clip (MP3) via ElevenLabs Flash when BYOK key set. Cost: $0.25 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"0.25","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":2500},"voiceId":{"type":"string"}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/background-removals":{"post":{"operationId":"generate_background_removal","summary":"Remove background from an image URL. Returns transparent PNG. Cost: $0.10 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"0.10","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/transcriptions":{"post":{"operationId":"generate_transcription","summary":"Transcribe audio from a URL via Workers AI Whisper. Returns plain text. Cost: $0.05 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"0.05","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["audioUrl"],"properties":{"audioUrl":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/pdfs":{"post":{"operationId":"generate_pdf_document","summary":"Render HTML or markdown to a PDF via Cloudflare Browser Rendering. Cost: $0.15 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"0.15","alsoAccepts":"Bearer API key with prepaid credits","async":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string"},"markdown":{"type":"string"},"title":{"type":"string"}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}},"/v1/videos":{"post":{"operationId":"generate_video_clip","summary":"Generate a short video clip from a text prompt (async job). Poll job or provide webhook. Cost: $2.00 USDC.","x-payment-info":{"protocol":"x402","asset":"USDC","network":"base","priceUsdc":"2.00","alsoAccepts":"Bearer API key with prepaid credits","async":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string"},"durationSec":{"type":"integer","default":5},"webhookUrl":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Asset generated"},"202":{"description":"Async job queued"},"402":{"description":"Payment required or insufficient credits"}}}}}}