# Account API

Read your account through the API: the credits left, the top up balance, today's prices, the limits, and what this key has spent.

## Get the account

`GET /api/v1/account`

Needs **Account: Read**.

```bash
curl https://10xvid.com/api/v1/account \
  -H "Authorization: Bearer $TENX_API_KEY"
```

```json
{
  "object": "account",
  "email": "you@example.com",
  "plan": "studio",
  "credits": { "left": 191500, "included": 250000, "resets": "2026-11-01T00:00:00.000Z" },
  "balance": { "usd": 42.5 },
  "spent_this_month": { "usd": 17.68 },
  "key": { "id": "keymgn5c1a2b8f3e0d", "scopes": "all", "limit": null, "spent_this_month": { "usd": 6.4 } },
  "prices": {
    "read_site": { "usd": 2.3, "credits": 2298, "unit": "site", "per": "each site", "name": "Reading a site" },
    "format_dna": { "usd": 0.25, "credits": 250, "unit": "format_dna", "per": "each Format DNA", "name": "Building a Format DNA" },
    "video": { "usd": 0.18, "credits": 180, "unit": "second", "per": "each second of video, in each aspect ratio", "name": "Making a video" },
    "lite_video": { "usd": 0.07, "credits": 70, "unit": "second", "per": "each second of video, in each aspect ratio", "name": "Making a Motion V1 Flash video" },
    "voiceover": { "usd": 2.19, "credits": 2190, "unit": "1000_characters", "per": "each 1,000 characters spoken", "name": "Voiceover" },
    "music": { "usd": 0.04, "credits": 40, "unit": "second", "per": "each second of video", "name": "Music" }
  },
  "limits": { "videos_at_once": 10, "styles_per_format": 10, "videos_per_call": 6 },
  "images": true,
  "docs": "https://10xvid.com/docs/api"
}
```

| Field | What it is |
|---|---|
| `credits` | Your plan's credits: what is `left`, what the plan `included`, and when they come back. They pay before the balance. |
| `balance` | The top up balance, in dollars. |
| `spent_this_month` | What the top up balance paid for this calendar month. |
| `key` | The key that asked: its id, what it may reach (`all`, or each part and its level), its monthly limit, and what it spent this month. |
| `prices` | What one of each thing costs today, in dollars and credits, for one `unit`: `video` and `lite_video` (a video made by Motion V1 Flash) a `second` in each aspect ratio, `voiceover` 1,000 characters (`1000_characters`), `music` a `second` of video, `image` an image, and `read_site`, `format_dna`, `format_update` and `reference_video` one of each, on average (each is charged what it really used). See [API pricing](/docs/api/pricing). |
| `limits` | Videos made at once for the account, styles in one format, and videos in one call. |
| `images` | Whether image ads can be made. |

The prices in the example are only an example: read them from your own account.