{"uid":"cap_lclCXhdCOjat5t91lPOjn","slug":"maginary-ai-image-video-generation-14e7e272","name":"Maginary AI Image & Video Generation","description":"Generate AI images or video from a text prompt with Midjourney-style --flags (--ar 16:9, --v, --flagship, ...). Async: returns a generation record; poll GET /api/gens/{uuid}/ or set callback_url for a webhook. Pay-to-play: without credits you get a 402 priced for this prompt; settle the exact USDC on Base via x402 and retry. No account needed: first settlement creates the account; subsequent requests use wallet-signed headers (see 402 wallet_auth). Paying accepts https://maginary.ai/terms.","url":"https://app.maginary.ai/api/gens/","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","description":"Prompt text plus optional --flags (see /api/parameters/)."},"recipe_uuid":{"type":"string","description":"Optional recipe to run the prompt through."},"callback_url":{"type":"string","format":"uri","description":"Optional HTTPS webhook for DONE/FAILED."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.07","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":"$0.28/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.28","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.28","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6Xfkzw4u_tZPgkCCQv7Ks","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.28","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates AI images or video from a text prompt with Midjourney-style flags, returning an async generation record payable in USDC via x402","exampleAgentPrompt":"Generate an AI image of a futuristic Tokyo skyline at night with neon lights and rain, in 16:9 widescreen format using the flagship model, and let me know when it's done.","exampleUseCases":[{"title":"Social media banner creation","prompt":"Create a wide 16:9 AI image of a serene mountain lake at sunrise with fog rolling over the water — make it ultra-realistic and high quality using the best available model."},{"title":"Automated content pipeline with webhook","prompt":"Generate an AI illustration of a cozy coffee shop interior with warm lighting and bookshelves, and send a webhook to https://myapp.example.com/hooks/image-done when it's finished so my pipeline can pick it up."},{"title":"Short AI video clip for a product demo","prompt":"Generate a short AI video of a sleek electric sports car driving through a desert highway at golden hour, cinematic style, 16:9 aspect ratio."}],"resultDescription":"Returns a generation record containing a UUID and status (e.g. PENDING or DONE). The agent must poll GET /api/gens/{uuid}/ or receive a webhook callback to retrieve the final image or video URL once processing completes. If no credits are available, returns a 402 response with the USDC price required to unlock the generation on Base chain; after payment the request can be retried, and the first payment also returns an API key for future calls.","failureModes":["402 Payment Required — insufficient credits; response includes exact USDC price needed to proceed via x402 on Base","Invalid prompt or missing required 'prompt' field — 400 Bad Request","Invalid callback_url format — 400 validation error","Generation fails during processing — status set to FAILED, webhook fires with FAILED event if callback_url provided","Unknown recipe_uuid — 404 or validation error","Network timeout on poll — agent must retry GET /api/gens/{uuid}/"],"whenToPreferThis":"Choose this endpoint when you need to generate AI images or video from a text prompt with Midjourney-style flag controls (aspect ratio, model version, flagship quality) and can handle async results via polling or webhooks. It is especially useful for walletless or accountless workflows where payment is handled on-the-fly with USDC on Base via x402 — no signup required. Prefer this over synchronous image APIs when generation latency is acceptable and you want pay-per-use crypto billing without pre-registered credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:36:43.957Z","isFirstParty":false}