Manual Video Tracking | Paygent Documentation

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

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
)