Skip to main content
POST
/
v1
/
videos
/
estimate
Estimate the credit cost of a video generation
curl --request POST \
  --url https://api.aurous-labs.com/v1/videos/estimate \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "video_lora_id": "lora_01HXMQ7Z3K8Y2ABCDEFGHJKM",
  "prompt": "A golden sunset over the ocean with gentle waves",
  "first_frame_url": "file_01HXMQ7Z3K8Y2NABCDEFGHJKMN",
  "last_frame_url": "https://example.com/last.jpg",
  "duration": 5,
  "seed": 123,
  "camera_fixed": true,
  "watermark": true,
  "enhance_prompt": true,
  "webhook_url": "<string>"
}
'
{
  "object": "estimate",
  "estimated_cost": {
    "amount": 2,
    "breakdown": {
      "base": 1,
      "enhance": 1
    }
  },
  "currency": "credit"
}

Authorizations

​
X-Api-Key
string
header
required

Your team API key (starts with al_live_).

Headers

​
Aurous-Version
string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-05-15 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-05-15"

Body

application/json
​
video_lora_id
string
required

Opaque video LoRA identifier (lora_*) or slug. UUIDs accepted for legacy back-compat.

Example:

"lora_01HXMQ7Z3K8Y2ABCDEFGHJKM"

​
prompt
string

Text prompt describing the video. Optional — enhances the generation when provided.

Example:

"A golden sunset over the ocean with gentle waves"

​
first_frame_url
string

First frame for image-to-video / first+last frame interpolation. Either an opaque file_<ulid> ID returned by POST /v1/files, or an https:// URL pointing at a public host (max 2048 chars). URLs are server-side fetched through an SSRF-pinned client (rejects private IPs / cloud metadata).

Maximum string length: 2048
Example:

"file_01HXMQ7Z3K8Y2NABCDEFGHJKMN"

​
last_frame_url
string

Last frame for first+last frame interpolation. Same rules as first_frame_url.

Maximum string length: 2048
Example:

"https://example.com/last.jpg"

​
resolution
enum<string>

Output video resolution

Available options:
480p,
720p,
1080p
​
ratio
enum<string>

Output video aspect ratio

Available options:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9
​
duration
number

Video duration in seconds (2-12)

Required range: 2 <= x <= 12
Example:

5

​
seed
number

Random seed (-1 for random)

​
camera_fixed
boolean

Whether to fix the camera position

​
watermark
boolean

Whether to add watermark

​
enhance_prompt
boolean

Whether to enhance the prompt with AI

​
webhook_url
string

Webhook URL to receive POST callback when generation completes or fails

Response

Cost estimate

​
object
enum<string>
required

Discriminator

Available options:
estimate
Example:

"estimate"

​
estimated_cost
object
required

Cost breakdown for this would-be generation.

​
currency
enum<string>
required

Currency unit. All amounts in this response are in credit.

Available options:
credit
Example:

"credit"