Introspection API

What the introspection endpoints are for

Three read-only endpoints that answer the questions a client asks before it does anything else: which account am I, what can I afford, and what can I make.

Call GET /tools first in almost any integration. It returns the create tools and the brief fields each one expects, which is what a POST /videos call needs to fill in. Hardcoding a tool id and its fields works until the tool library changes; reading them at runtime does not break.

curl https://app.makeaivideo.ai/api/v1/tools \
  -H "Authorization: Bearer $MAV_API_KEY"

Introspection API questions

How do I check an API key's credit balance?

Call GET /credits. It returns the balance for the organization the key belongs to, which is the right guard for a long-running job that would otherwise fail partway through a batch.

What does GET /tools return?

The create tools available to your account, each with the brief fields it expects. Those field names are what you pass in the fields object on POST /videos.

Which account does an API key act as?

GET /me identifies the account and organization behind the key. Keys belong to an organization rather than a person, so this is how a client confirms which workspace it is writing into.