Skip to main content
GET
/
pictoryapis
/
v1
/
quota
Get Current Quota
curl --request GET \
  --url https://api.pictory.ai/pictoryapis/v1/quota \
  --header 'Authorization: <authorization>'
{
  "videoMinutes":               { "used": 98,  "limit": 14400 },
  "transcriptionMinutes":       { "used": 0,   "limit": 14400 },
  "elevenLabsVoiceOverMinutes": { "used": 33,  "limit": 480 },
  "aiCredits":                  { "used": 690, "limit": 22000 }
}

​
Overview

Retrieve a real-time snapshot of the quotas associated with your Pictory subscription. The response shows how much of each quota you have used so far in the current billing term and how much is allowed by your plan. The endpoint reports the following four metrics:
  • Video minutes rendered through Pictory’s video generation pipeline
  • Transcription minutes consumed by transcription jobs
  • ElevenLabs VoiceOver minutes used for AI text-to-speech
  • AI credits consumed by generative AI features such as AI avatars, text-to-image, and AI video generation
Use this endpoint when you need to display a usage summary in your application, gate a feature based on remaining quota, or verify that a subscription has capacity before launching a long-running job.
You need a valid API key to use this endpoint. Get your API key from the API Access page in your Pictory dashboard.

​
API Endpoint

GET https://api.pictory.ai/pictoryapis/v1/quota

​
Request Parameters

​
Headers

​
Authorization
string
required
API key for authentication (starts with pictai_)
Authorization: YOUR_API_KEY
This endpoint does not accept any path, query, or body parameters. The subscription is identified from the API key.

​
Response

Returns an object containing four usage entries. Every entry has the same shape: used reports the amount consumed in the current billing term and limit reports the maximum allowed by the plan.
​
videoMinutes
object
required
Video minutes rendered in the current billing term.
​
transcriptionMinutes
object
required
Transcription minutes consumed in the current billing term.
​
elevenLabsVoiceOverMinutes
object
required
ElevenLabs AI voice-over minutes consumed in the current billing term.
​
aiCredits
object
required
AI credits consumed in the current billing term. AI credits power generative features such as AI avatars, text-to-image, and AI video generation.

​
Response Examples

{
  "videoMinutes":               { "used": 98,  "limit": 14400 },
  "transcriptionMinutes":       { "used": 0,   "limit": 14400 },
  "elevenLabsVoiceOverMinutes": { "used": 33,  "limit": 480 },
  "aiCredits":                  { "used": 690, "limit": 22000 }
}

​
Code Examples

Replace YOUR_API_KEY with your actual API key that starts with pictai_
curl --request GET \
  --url 'https://api.pictory.ai/pictoryapis/v1/quota' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'accept: application/json' | python -m json.tool