Queue priority

Priority video encoding for paid urgent jobs

Submit high-priority video jobs through the API or dashboard when customers pay for faster queue placement.

Priority should be a real product behavior, not a cosmetic flag. Convertrilo keeps paid priority jobs in the queue lane the worker understands and bills them with the appropriate multiplier.

Request high priorityfeature
await client.onDemandEncode({
  sourceUrl: "https://example.com/customer-rush.mp4",
  codec: "h264",
  resolution: "1080p",
  quality: "better",
  priority: "high"
});

Place urgent paid jobs ahead of normal priority work.

Keep public/free jobs out of the paid priority lane.

Expose priority in pricing and billing metadata.

Use the same priority behavior from dashboard, API, and SDK workflows.

How it works

Encoding behavior that maps to the real worker path

These capability pages describe concrete job behavior: payload fields, worker choices, FFmpeg execution, and terminal output handling.

  1. Step 1

    A customer or automation flow submits a job with high priority.

  2. Step 2

    The API reserves credits using the high-priority multiplier.

  3. Step 3

    BullMQ stores the job in the prioritized queue lane.

  4. Step 4

    The Rust worker claims prioritized jobs correctly and processes them through the normal encode lifecycle.

Paid urgency

Use high priority for customer-facing, deadline-sensitive, or premium plan work.

Queue compatibility

The Rust worker supports BullMQ priority lanes so paid priority jobs do not get stranded.

Clear billing

Priority affects the on-demand multiplier and is recorded in billing metadata for reconciliation.

Feature questions

Does priority make encoding itself faster?

Priority affects queue placement, not FFmpeg speed. Once a job starts, runtime depends on source duration, codec, resolution, hardware, and optimization settings.

Should public free jobs use priority?

No. Public jobs should stay in the normal lane so paid priority remains meaningful.

Can API users request priority?

Yes. API and SDK on-demand jobs can request normal or high priority when the API key has permission to create jobs.

Related capability pages

Start with a real estimate

Choose your codec, resolution, FPS, bitrate, quality, and optimization settings. Convertrilo shows the NEU estimate before credits are reserved, and failed jobs release reserved credits back to your balance.