{"uid":"cap_GV9chzqg31rVLr6FgB1bv","slug":"agents-vimmerse-net-vimmerse-reframe-video-2686c235","name":"Vimmerse Reframe Video","description":"AI reframing (Luma) to a new **`aspect_ratio`** using **`prompt`**. Optional grid/position fields fine-tune the frame.\n\n```python\nimport requests\n\nr = requests.post(\n    \"https://api.vimmerse.net/v2/video/reframe\",\n    headers={\"X-Api-Key\": \"YOUR_API_KEY\", \"Content-Type\": \"application/json\"},\n    json={\n        \"video_url\": \"https://…/input.mp4\",\n        \"aspect_ratio\": \"16:9\",\n        \"prompt\": \"Make it realistic\",\n        \"async_mode\": True,\n    },\n    timeout=60,\n)\nprint(r.json())\n```","url":"https://agents.vimmerse.net/v2/video/reframe?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"ReframeVideoRequest","required":["video_url"],"properties":{"x_end":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"X End"},"y_end":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Y End"},"prompt":{"type":"string","title":"Prompt","default":"Make it realistic"},"x_start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"X Start"},"y_start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Y Start"},"video_url":{"type":"string","title":"Video URL"},"async_mode":{"type":"boolean","title":"Async Mode","default":false},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook URL"},"aspect_ratio":{"type":"string","title":"Aspect Ratio","default":"16:9","pattern":"^(\\d+):(\\d+)$"},"grid_position_x":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Grid Position X"},"grid_position_y":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Grid Position Y"}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"1.2","displayCostAsset":"USD","priceDynamic":true,"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":"dynamic","summary":"$1.2/call (dynamic — varies by input)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"1.2","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"1.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_32At9xommjf0Rs8VuXKU7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"1.2","costPer":"request","priority":0,"asset":"usd","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"AI-powered video reframing to a new aspect ratio using Luma, with optional prompt and grid/position fine-tuning","exampleAgentPrompt":"Can you reframe this video (https://example.com/myclip.mp4) to a 9:16 vertical aspect ratio? Use the prompt 'cinematic and realistic' and run it asynchronously.","exampleUseCases":[{"title":"Convert landscape video to TikTok vertical","prompt":"Take this video at https://cdn.example.com/product_demo.mp4 and reframe it to 9:16 for TikTok — use the prompt 'make it look natural and realistic' and run it async."},{"title":"Reframe interview video to square for Instagram","prompt":"I have a 16:9 interview recording at https://media.example.com/interview.mp4 and I need it reframed to a 1:1 square format for Instagram. Use the default realistic prompt and run it async."},{"title":"Smart crop cinematic film clip to widescreen","prompt":"Please reframe this clip at https://assets.example.com/scene.mp4 to a 21:9 ultra-wide aspect ratio with the prompt 'epic cinematic landscape', and let me know when it's done via webhook at https://myapp.com/webhook."}],"resultDescription":"Returns a job object containing a job/media ID that can be polled until the reframed video is ready, along with status and (on completion) a URL to the output video in the new aspect ratio.","failureModes":["Invalid video URL or inaccessible source video","Unsupported or malformed aspect ratio string (must match \\d+:\\d+ pattern)","Processing timeout for very long videos","Insufficient credits/payment failure ($1.20 per call)","Webhook URL unreachable if provided","Luma AI backend processing error"],"whenToPreferThis":"Use this endpoint when you need to intelligently reframe an existing video to a new aspect ratio using AI (Luma) rather than simple cropping — ideal when preserving subject focus across the reframed output is important. Prefer this over manual cropping tools when the source video has meaningful content that needs smart centering, or when you need to adapt content for different social media platforms (e.g., converting 16:9 YouTube content to 9:16 TikTok/Reels format).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:39:45.963Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-reframe-video-2686c235"}