# Vimmerse Crop Video to Aspect Ratio

> Vimmerse Crop Video to Aspect Ratio is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, $0.6/call (dynamic — varies by input), status unknown (last checked 2026-10-31).

Crops a video to a specified aspect ratio with optional X/Y offset for crop origin control.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/video/crop-to-aspect-ratio?utm_source=zero.xyz
- Price: $0.6/call (dynamic — varies by input)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Provider: agents.vimmerse.net
- Website: https://agents.vimmerse.net
- Canonical page: https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-crop-video-to-aspect-ratio-445899a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZTLSu3S9N5MfSuPHJZ6SF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-vimmerse-net-vimmerse-crop-video-to-aspect-ratio-445899a2 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Crops **`video_url`** to **`aspect_ratio`**. Optional **`offset_x`** / **`offset_y`** set the crop origin (default: center).

Most clients should use **`async_mode`: true** (default).

```python
import requests

r = requests.post(
    "https://api.vimmerse.net/v2/video/crop-to-aspect-ratio",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={"video_url": "https://…/input.mp4", "aspect_ratio": "9:16", "async_mode": True},
    timeout=60,
)
print(r.json()["status"], r.json().get("results"))
```

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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+)$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-crop-video-to-aspect-ratio-445899a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.vimmerse.net](https://www.zero.xyz/host/agents.vimmerse.net/llms.txt)