{"uid":"cap_ZTLSu3S9N5MfSuPHJZ6SF","slug":"agents-vimmerse-net-vimmerse-crop-video-to-aspect-ratio-445899a2","name":"Vimmerse Crop Video to Aspect Ratio","description":"Crops **`video_url`** to **`aspect_ratio`**. Optional **`offset_x`** / **`offset_y`** set the crop origin (default: center).\n\nMost clients should use **`async_mode`: true** (default).\n\n```python\nimport requests\n\nr = requests.post(\n    \"https://api.vimmerse.net/v2/video/crop-to-aspect-ratio\",\n    headers={\"X-Api-Key\": \"YOUR_API_KEY\", \"Content-Type\": \"application/json\"},\n    json={\"video_url\": \"https://…/input.mp4\", \"aspect_ratio\": \"9:16\", \"async_mode\": True},\n    timeout=60,\n)\nprint(r.json()[\"status\"], r.json().get(\"results\"))\n```","url":"https://agents.vimmerse.net/v2/video/crop-to-aspect-ratio?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"CropToAspectRatioRequest","required":["video_url"],"properties":{"offset_x":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"X-Axis Offset"},"offset_y":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Y-Axis Offset"},"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+)$"}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.6","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":"$0.6/call (dynamic — varies by input)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fLecUitPxQ1r7Ss-ucCCF","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.6","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":"Crops a video to a specified aspect ratio with optional X/Y offset for crop origin control.","exampleAgentPrompt":"Crop this video to a 9:16 vertical aspect ratio so it fits TikTok — here's the URL: https://example.com/myclip.mp4. Use async mode and center the crop.","exampleUseCases":[{"title":"Reformat landscape video for TikTok","prompt":"I have this YouTube-style 16:9 video at https://cdn.example.com/promo.mp4 — can you crop it to 9:16 so I can post it on TikTok? Use the center crop origin."},{"title":"Square crop for Instagram feed","prompt":"Take the video at https://media.example.com/interview.mp4 and crop it to a 1:1 square format for Instagram. Shift the crop 50 pixels to the right on the X axis so the subject stays centered."},{"title":"Portrait crop for mobile ad campaign","prompt":"I need to reformat our ad video at https://assets.mybrand.com/ad_wide.mp4 from landscape to a 4:5 portrait format for mobile ads. Run it asynchronously and notify me at https://hooks.mybrand.com/done when it's ready."}],"resultDescription":"Returns a job status and, once complete, a results object containing the URL or asset details of the cropped video. In async mode, the job ID is returned immediately and the result is delivered via webhook or polled by ID.","failureModes":["Invalid or inaccessible video_url returns an error","Unsupported or malformed aspect_ratio pattern (must match \\d+:\\d+) causes a 422 validation error","offset_x or offset_y out of bounds for the source video dimensions may cause crop failure","Payment failure or insufficient credits returns a 402 response","Async job timeout if video is very large or network is slow"],"whenToPreferThis":"Use this endpoint when you need to reformat an existing video to a different aspect ratio for platform-specific publishing (TikTok, Instagram, YouTube Shorts, etc.) without regenerating the video. Prefer this over manual editing tools when automating content pipelines or when crop origin control is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:42:16.938Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-crop-video-to-aspect-ratio-445899a2"}