Models and account
Two read endpoints complete the API: the public model list and the authenticated account snapshot. Use them before spending credits.
GET /v1/models
Public, no key required. It returns every tier's limits and the exact credit matrix the API charges.
{
"video": [
{
"id": "lite",
"resolutions": ["480p", "720p"],
"min_duration": 5,
"max_duration": 10,
"supports_audio": false,
"prices": { "480p": { "5": 3 }, "720p": { "5": 3 } }
}
],
"image": [
{
"id": "lite",
"resolutions": ["2k"],
"aspect_ratios": ["1:1", "4:3", "16:9", "9:16", "adaptive"],
"max_reference_images": 3,
"credits": 1
}
],
"max_prompt_length": 8000
}| Field | Values |
|---|---|
| video | one object per video tier: id, resolutions, min_duration, max_duration, supports_audio, and prices (resolution → duration → credits) |
| image | one object per image tier: id, resolutions, aspect_ratios, max_reference_images, credits |
| max_prompt_length | the character limit for prompt (8,000) |
video
- Values
- one object per video tier:
id,resolutions,min_duration,max_duration,supports_audio, andprices(resolution → duration → credits)
image
- Values
- one object per image tier:
id,resolutions,aspect_ratios,max_reference_images,credits
max_prompt_length
- Values
- the character limit for
prompt(8,000)
GET /v1/account
Authenticated. Returns the credit balance, plan flags and the identity of the key you used.
{
"credits": 120,
"is_paid": true,
"is_premium": false,
"key": { "id": 12, "name": "my-script", "prefix": "du_live_ab12" }
}| Field | Values |
|---|---|
| credits | available generation credits |
| is_paid | whether the account has bought credits |
| is_premium | whether the account can request audio on pro |
| key | the key that made this request: id, name and prefix, never the secret |
credits
- Values
- available generation credits
is_paid
- Values
- whether the account has bought credits
is_premium
- Values
- whether the account can request audio on
pro
key
- Values
- the key that made this request:
id,nameandprefix, never the secret
Check credits before a batch, and read prices instead of hard-coding costs. A 402 means the balance is short; nothing was charged.