Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Currents trace Animation API
version: '1'
description: On-demand access to Playwright trace contents (screencast frames, trace summary, DOM snapshots, network requests, attachments) via ranged zip reads. Human-readable docs at /docs.
servers:
- url: https://t.crts.sh
tags:
- name: Animation
paths:
/{slug}/animation:
get:
summary: Animated screencast, rendered on demand
description: Samples up to frames= screencast frames and muxes them into an animated WebP (or GIF). Each parameter combination is cached as its own variant, so embeds can pick a size without a stored artifact.
parameters:
- name: slug
in: path
required: true
description: Link slug minted by the Currents backend; grants read access to one trace until the link expires.
schema:
type: string
pattern: ^[A-Za-z0-9_-]{16}$
- name: format
in: query
required: false
description: webp (default) or gif
schema:
type: string
enum:
- webp
- gif
- name: frames
in: query
required: false
description: frames to sample
schema:
type: integer
minimum: 1
maximum: 150
default: 60
- name: width
in: query
required: false
description: resize to at most this width
schema:
type: integer
minimum: 16
maximum: 2560
default: 720
- name: quality
in: query
required: false
description: WebP quality
schema:
type: integer
minimum: 1
maximum: 100
default: 75
- name: overlay
in: query
required: false
description: progress draws a frame counter (e.g. 12/60) in the bottom-right corner of every frame
schema:
type: string
enum:
- progress
responses:
'200':
description: Animated screencast, rendered on demand (image/webp | image/gif)
headers:
x-animation-frames:
description: frames in the output
schema:
type: string
x-animation-source-frames:
description: screencast frames in the trace
schema:
type: string
'400':
description: invalid parameters
'404':
description: unknown or expired link, or not found in this trace
'413':
description: the trace is larger than the worker can read
'422':
description: the trace artifact is not a readable zip
'502':
description: the trace could not be fetched from storage
'503':
description: this deployment has no link bucket bound, so no link can be read
tags:
- Animation
operationId: getBySlugAnimation
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer