> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.withpaygent.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withpaygent.com/_mcp/server.

# Manual Video Tracking

Use manual tracking when you have direct access to video metrics or are using a video provider that is not yet automatically patched by the SDK.

## General Example

Initialize the `VideoUsageData` model and send it via `send_usage_video()`.

**`manual_video_tracking.py`**

```python title="manual_video_tracking.py"
import paygent_sdk
from paygent_sdk.models import VideoUsageData

# 1. Initialize Paygent
paygent = paygent_sdk.init(api_key="your-paygent-api-key")

# 2. Define Video Usage
# Required: provider, model, video_duration_sec
# Optional: video_resolution, video_is_audio, plan
video_usage = VideoUsageData(
    provider="Runway",
    model="gen-3-alpha",
    video_duration_sec=15.0,
    video_resolution="1280x720",
    video_is_audio=True
)

# 3. Send Usage
paygent.send_usage_video(
    agent_id="my-video-agent",
    customer_id="customer-99",
    indicator="video-generation-completed",
    video_usage=video_usage
)
```