Avatars

Get avatar usage

Changed on

Get aggregate usage statistics for avatar conversations, including total duration, session counts, average duration, and a per-day breakdown. Per-day buckets are keyed by UTC calendar date. The date range must not exceed 90 days.

get/v1/avatar_usage

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/avatar_usage
  • Auth
    HTTP bearer

Query parameters

startDatestring date-time required

Start of the date range in UTC (inclusive). Required.

endDatestring date-time required

End of the date range in UTC (exclusive). Required.

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Response

Success

totalSecondsinteger required

Total seconds across conversations with a measured duration in the date range.

totalSessionsinteger required

Number of conversations started in the date range. Includes unfinished and failed conversations.

avgDurationSecondsinteger required

Average duration in seconds across conversations with a measured duration, or 0 if none completed. May not equal totalSeconds / totalSessions because unfinished conversations contribute to the session count but not the duration.

Changes