cottom/av-tools | API reference

Media probes and checks for the platform's av-tools: an upload's length, an image's decode, a video's billed seconds, a compact MP3, an export's format, a video's first or last frame. The same tools and static ffmpeg build as its Cloudflare backend.

Public

709 runs

Playground API Examples README Versions

Run cottom/av-tools with an API

Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.

Input schema

The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.

Field	Type	Default value	Description
tool	string		The av-tools tool to run: a key of catalog.json `tools`.
source_url	string		The input's https URL (a short-lived read grant).
options	string		The tool's options as JSON, exactly its row's `options` in catalog.json.
expect_bytes	integer	0	The input's size the caller expects; 0 checks none.
expect_sha256	string		The input's hex SHA-256 the caller expects; empty checks none.
deliver	string		A file tool's delivery as JSON (`AvToolDeliver`): its digest only, or a PUT to a presigned " "upload bound to that digest; empty returns the file.

{
  "type": "object",
  "title": "Input",
  "required": [
    "tool",
    "source_url",
    "options"
  ],
  "properties": {
    "tool": {
      "type": "string",
      "title": "Tool",
      "x-order": 0,
      "description": "The av-tools tool to run: a key of catalog.json `tools`."
    },
    "deliver": {
      "type": "string",
      "title": "Deliver",
      "default": "",
      "x-order": 5,
      "description": "A file tool's delivery as JSON (`AvToolDeliver`): its digest only, or a PUT to a presigned \"\n                        \"upload bound to that digest; empty returns the file."
    },
    "options": {
      "type": "string",
      "title": "Options",
      "x-order": 2,
      "description": "The tool's options as JSON, exactly its row's `options` in catalog.json."
    },
    "source_url": {
      "type": "string",
      "title": "Source Url",
      "x-order": 1,
      "description": "The input's https URL (a short-lived read grant)."
    },
    "expect_bytes": {
      "type": "integer",
      "title": "Expect Bytes",
      "default": 0,
      "minimum": 0,
      "x-order": 3,
      "description": "The input's size the caller expects; 0 checks none."
    },
    "expect_sha256": {
      "type": "string",
      "title": "Expect Sha256",
      "default": "",
      "x-order": 4,
      "description": "The input's hex SHA-256 the caller expects; empty checks none."
    }
  }
}

Output schema

The shape of the response you’ll get when you run this model with an API.

Schema

{
  "type": "array",
  "items": {
    "type": "string",
    "format": "uri"
  },
  "title": "Output"
}