Account API

Get account information, organization details, and rate limit usage.

Endpoints

GET

/api/v1/organization

Get organization details and credits

GET

/api/v1/account/rate-limits

Get current rate limit usage

Get Organization

GET

/api/v1/organization

Retrieve your organization's details including current credit balance.

Example Request

"text">-purple-600">curl https://vydra.app/api/v1/organization \
  "text-blue-600">-H "Authorization: Bearer YOUR_API_KEY"

Responsejson

{
  "id": "org_abc123",
  "name": "My Organization",
  "plan": "starter",
  "creditsRemaining": 4250,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-26T12:00:00.000Z"
}

Response Fields

Name	Type	Description
`id`	`string`	Organization ID
`name`	`string`	Organization name
`plan`	`string`	Subscription plan (free, starter, creator)
`creditsRemaining`	`number`	Current credit balance
`createdAt`	`string`	Account creation date
`updatedAt`	`string`	Last update date

Get Rate Limit Usage

GET

/api/v1/account/rate-limits

Check your current rate limit usage and remaining quota.

Example Request

"text">-purple-600">curl https://vydra.app/api/v1/account/rate"text-blue-600">-limits \
  "text-blue-600">-H "Authorization: Bearer YOUR_API_KEY"

Responsejson

{
  "plan": "starter",
  "limits": {
    "rpm": 30,
    "rph": 500,
    "rpd": 5000,
    "concurrent": 5
  },
  "usage": {
    "minute": { "used": 12, "limit": 30 },
    "hour": { "used": 87, "limit": 500 },
    "day": { "used": 342, "limit": 5000 }
  },
  "timestamp": "2026-01-26T12:00:00.000Z"
}

Response Fields

Name	Type	Description
`plan`	`string`	Current subscription plan
`limits.rpm`	`number`	Requests per minute limit
`limits.rph`	`number`	Requests per hour limit
`limits.rpd`	`number`	Requests per day limit
`limits.concurrent`	`number`	Max concurrent jobs
`usage.minute`	`object`	Current minute usage
`usage.hour`	`object`	Current hour usage
`usage.day`	`object`	Current day usage
`timestamp`	`string`	Time of this response

For more details on rate limiting, see the Rate Limits documentation.

Subscription Plans

Plan	Starting Credits	RPM	Concurrent Jobs
Free	100	10	2
Starter	1,000	30	5
Creator	5,000	60	10

Credit Costs

Different operations cost different amounts of credits:

Operation	Credits
Gemini 2.0 Flash (generate/edit)	5
Nano Banana (generate/edit)	8
Flux 2 Edit	15
House Timelapse	150
Renovation Timelapse (Quick)	50
Renovation Timelapse (Premium)	150
Character Swap	100
Upload (file storage)	Free