{"uid":"cap_-IbQSSQdC0LcySz9Audmy","slug":"haven-video-generation-api-62d632f4","name":"Haven Video Generation API","description":"Haven is a private AI agent for your home. Join the waitlist for h1 speaker updates and early app access.","url":"https://api.havenagent.ai/x402/api/v1/video","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"width":{"type":"number","default":1024,"maximum":1280,"minimum":256},"height":{"type":"number","default":576,"maximum":1280,"minimum":256},"prompt":{"type":"string","maxLength":2000,"minLength":1},"mediaType":{"enum":["image/png","image/jpeg"],"type":"string"},"imageBase64":{"type":"string","description":"base64 image bytes, no data-URI prefix"},"durationSeconds":{"type":"number","default":5,"maximum":10,"minimum":1}}},"responseSchema":{"type":"json","example":{"kind":"video","jobId":"00000000-0000-0000-0000-000000000000","status":"queued","resultUrl":"https://api.havenagent.ai/x402/api/v1/video/jobs/00000000-0000-0000-0000-000000000000/result","statusUrl":"https://api.havenagent.ai/x402/api/v1/video/jobs/00000000-0000-0000-0000-000000000000","etaSeconds":600,"aiDisclosure":{"label":"AI Generated","termsUrl":"https://havenagent.ai/terms/terms-of-service","statement":"AI Generated: this video is machine-generated by Haven Media and does not depict real events. Use terms: https://havenagent.ai/terms/terms-of-service","embeddedIn":"mp4-metadata","aiGenerated":true},"pollBudgetSeconds":1800}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.8","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.8/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.8","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.8","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tg3-JbQtvTGZlofXdj4gT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.8","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates an AI video clip from a text prompt and optional image, returning a job ID and polling URL for async result retrieval","exampleAgentPrompt":"Use Haven to generate a 5-second AI video of a cozy living room fireplace scene — here's an image of the room in PNG format, and animate it with the prompt 'warm fireplace glowing at night'.","exampleUseCases":[{"title":"Animate a home photo into video","prompt":"Take this JPEG photo of my backyard and animate it into a 7-second AI video with the prompt 'leaves gently falling on an autumn afternoon' — use Haven to generate it."},{"title":"Create a home scene video from text","prompt":"Generate a 5-second AI video of a modern kitchen in the morning with sunlight coming through the window, no image needed — just use the text prompt."},{"title":"AI video for a home security snapshot","prompt":"I have a base64-encoded PNG image from my front door camera — can you animate it into a 3-second AI video using the prompt 'quiet suburban street at dusk' via Haven?"}],"resultDescription":"Returns a JSON object with a job ID, initial status ('queued'), a result URL to fetch the finished MP4 video, a status polling URL, an estimated completion time (etaSeconds, typically ~600s), a poll budget (1800s), and an AI disclosure block embedded in the MP4 metadata indicating the video is machine-generated and does not depict real events.","failureModes":["Invalid or missing prompt returns a 4xx validation error","Base64 image data malformed or incorrectly padded causes rejection","Duration outside 1–10 second range returns validation error","Job times out if not polled within pollBudgetSeconds (1800s)","Payment failure via x402 protocol results in 402 response and no job creation","Unsupported mediaType enum value causes schema validation error"],"whenToPreferThis":"Choose this endpoint when you need to generate a short AI video clip (up to 10 seconds) from a text prompt alone or combined with a reference image, and are operating within a payment-enabled agent context using the x402 protocol. Prefer this over image-generation endpoints when motion output is required, and over third-party video APIs when privacy and home-context framing matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:36:01.202Z","isFirstParty":false}