Storage guide

Write encoded video outputs to S3-compatible storage

Route completed video encodes to S3-compatible buckets so your product keeps ownership of storage, CDN, lifecycle rules, and access control.

Use BYO S3 output when Convertrilo should handle encoding but your app should keep the finished object in its own storage account.

Create API keyAPI docsIntegration overview
Send output to S3guide
await client.onDemandEncode({
  sourceUrl: "https://example.com/source.mp4",
  externalId: "video_987",
  codec: "h265",
  resolution: "1080p",
  outputS3: {
    bucket: "customer-media",
    key: "encoded/video_987.mp4",
    region: "eu-central",
    endpoint: "https://s3.example.com"
  }
}, {
  idempotencyKey: "video_987:h265:1080p"
});

A readable source URL, S3 object, or ingest path.

S3-compatible destination credentials configured for your account.

A deterministic output key naming convention.

CDN or application logic that reads the completed object.

Recipe

Build the workflow with stable API primitives

These guides focus on primitives that can be reused by dashboards, queue workers, scripts, CLIs, MCP tools, and agent runtimes.

  1. Step 1

    Choose an output bucket and key before submitting the job.

  2. Step 2

    Submit the encode request with outputS3 destination settings or saved credentials.

  3. Step 3

    Wait for job completion before publishing the destination URL in your app.

  4. Step 4

    Use lifecycle, CDN, and access policies in your own storage account.

Storage ownership

Convertrilo can produce the file while your product retains object ownership, retention policy, and playback delivery.

Predictable object keys

Use asset ids and recipe names in output keys so repeated jobs are easy to reconcile and clean up.

S3-compatible providers

Use compatible object storage endpoints when your production stack is not AWS S3 but exposes the same storage contract.

Developer questions

Should outputs go to Convertrilo CDN or my own S3?

Use Convertrilo CDN for simple downloads. Use S3 output when your app needs ownership, custom CDN rules, private access, or storage lifecycle control.

Can I use S3 output with webhooks?

Yes. Wait for job.completed before publishing the S3 object path, because completion means the worker has finished upload and finalization.

Can folder workflows use S3 output?

Yes. Folder and batch workflows should derive deterministic output keys per source object.

Related developer paths

SDK quickstartInstall the Convertrilo TypeScript SDK, create an API key, submit a retry-safe encoding job, and wait for a completed output.Queue automationConnect Convertrilo to your own queues, cron jobs, imports, and backfills without duplicating jobs when retries happen.Webhook receiverReceive signed Convertrilo job events, verify the HMAC signature, and update your own product when outputs are ready.MCP setupInstall @convertrilo/sdk, save an API key with the CLI, configure convertrilo-mcp in an MCP client, and verify the available video encoding tools.Agent workflowsDesign agent-friendly video encoding workflows with the Convertrilo MCP server, scoped API keys, deterministic job payloads, idempotency, polling, and signed webhooks.Video encoding APICreate video encoding jobs from your backend with API keys, idempotency, metadata, priority queues, webhooks, and storage destinations you control.Video encoding CLIAutomate video compression from terminals, deployment jobs, content pipelines, and scheduled scripts with a Convertrilo CLI workflow.VMAF video encodingUse VMAF-guided sample encoding to choose a better quality target before the final video encode, without manually testing bitrate settings.Two-pass video encodingUse classic two-pass H.264 and H.265 encoding when predictable bitrate allocation matters more than raw hardware speed.

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.

Start FreeCalculate Pricing