Usage
Monitor your current billing period usage, quotas, and API request statistics.
Get usage statistics
GET
/usageGet usage statistics
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
X-Organization-ID | string | Optional | Specify organization context for multi-org users. If omitted, uses default org for API key. |
curl -X GET https://logtalk.io/api/v1/usage \-H "Authorization: Bearer lt_live_your_api_key_here" \-H "Content-Type: application/json"
Examples
cURL
curl https://logtalk.io/api/v1/usage \-H "Authorization: Bearer lt_live_your_key"
Node.js
const response = await fetch('https://logtalk.io/api/v1/usage', {headers: {'Authorization': `Bearer ${process.env.LOGTALK_API_KEY}`}});const { data } = await response.json();console.log(`Audio: ${data.audio.used}/${data.audio.quota}`);console.log(`Video: ${data.video.used}/${data.video.quota}`);console.log(`Credits available: ${data.credits.available}`);
Python
import requestsimport osresponse = requests.get('https://logtalk.io/api/v1/usage',headers={'Authorization': f'Bearer {os.environ["LOGTALK_API_KEY"]}'})data = response.json()['data']print(f"Audio: {data['audio']['used']}/{data['audio']['quota']}")print(f"Video: {data['video']['used']}/{data['video']['quota']}")print(f"Credits: {data['credits']['available']}")
Response Fields
Billing Period
| Field | Type | Description |
|---|---|---|
period_start | string | Start of current billing period (ISO 8601) |
period_end | string | End of current billing period (ISO 8601) |
Audio & Video Quotas
Video generation is coming soon — the video fields are present in the response today but will always report zero usage.
| Field | Type | Description |
|---|---|---|
audio.quota | integer | Monthly audio episode limit |
audio.used | integer | Audio episodes used this period |
audio.remaining | integer | Remaining audio episodes |
video.quota | integer | Monthly video episode limit |
video.used | integer | Video episodes used this period |
video.remaining | integer | Remaining video episodes |
Credits
| Field | Type | Description |
|---|---|---|
credits.available | integer | Total available credits (audio + video) |
credits.audio_credits | integer | Audio episode credits available |
credits.video_credits | integer | Video episode credits available (coming soon) |
credits.expiring_soon | integer | Credits expiring within 30 days |
API Requests
| Field | Type | Description |
|---|---|---|
api_requests.today | integer | API requests made today (UTC) |
api_requests.daily_limit | integer | Maximum daily requests for your tier |
api_requests.this_minute | integer | Requests made in the current minute |
api_requests.minute_limit | integer | Maximum requests per minute for your tier |
Rate Limit Headers
All API responses include rate limit and quota information in headers, so you can monitor usage without polling GET /v1/usage on every request:
X-RateLimit-Limit: 500X-RateLimit-Remaining: 455X-RateLimit-Reset: 1705622400X-RateLimit-Limit-Minute: 60X-RateLimit-Remaining-Minute: 57X-Quota-Audio-Limit: 10X-Quota-Audio-Remaining: 3X-Quota-Video-Limit: 5X-Quota-Video-Remaining: 3X-Quota-Reset: 2026-02-01T00:00:00ZX-Quota-Credits-Available: 25
| Header | Description |
|---|---|
X-RateLimit-Limit | Your daily request limit |
X-RateLimit-Remaining | Remaining requests today |
X-RateLimit-Reset | Unix timestamp when daily limit resets |
X-RateLimit-Limit-Minute | Your per-minute request limit |
X-RateLimit-Remaining-Minute | Remaining requests this minute |
X-Quota-Audio-Limit | Monthly audio episode limit |
X-Quota-Audio-Remaining | Remaining audio episodes |
X-Quota-Video-Limit | Monthly video episode limit (coming soon) |
X-Quota-Video-Remaining | Remaining video episodes (coming soon) |
X-Quota-Reset | ISO 8601 timestamp for quota reset |
X-Quota-Credits-Available | Available credit balance |