Jobs

Get job pricing breakdown

Changed on
get/jobs/{id}/price

Request

  • Base URL: https://api.varg.ai/v2
  • URL: https://api.varg.ai/v2/jobs/{id}/price
  • Auth: HTTP bearer

Path parameters

idstring required

Response

Pricing breakdown

job_idstring
status'queued' | 'running' | 'awaiting_confirmation' | 'completed' | 'failed' | 'cancelled'

The status only moves forward: queued → running → completed, failed or cancelled. Everything a running job goes through — sending to the provider, uploading references, switching to another provider — is a stage of running; a job never goes back to queued. (Older API builds also reported submitting; treat it as running.)

awaiting_confirmation (multi-step pipelines only): the job finished a step that asks for review and waits for POST /jobs/{id}/confirm. It is not terminal.

modelstring nullable
toolstring

Internal tool id (e.g. tool_2001a2b3c4d5 for video), not the tool key. Use tool_key to tell tools apart.

tool_keystring nullable

Readable tool key (image, video, ...), as in GET /tools. null only if the tool registry could not be read.

pricing_idstring nullable
estimated_cost_centsinteger nullable
actual_cost_centsinteger nullable
billed_unitsobject nullable
children_countinteger

Sub-generations spawned by a render or pipeline job

total_cost_centsinteger

Own cost plus all children (equals own cost when children_count is 0)

Example response

{
  "tool": "tool_2001a2b3c4d5",
  "tool_key": "video",
  "billed_units": {
    "seconds": 6
  }
}

Changes