For Agents
Upload, transcode, and stream video and image assets with Gumlet. Manage live streams, playlists, subtitles, and webhooks for media delivery workflows.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Gumlet API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Gumlet API.
Create and direct-upload video assets, then poll asset status until transcoding completes
Generate or upload custom thumbnails for a video asset
Upload subtitle and audio tracks against an existing asset
GET STARTED
Use for: I need to upload a video to Gumlet for streaming, Create a new Gumlet video asset from a remote URL, Generate a thumbnail at a specific timestamp from a Gumlet video, Upload English subtitles to a Gumlet video asset
Not supported: Does not handle ad insertion, DRM licence issuance, or DAM editorial workflows — use for video and image transcoding, hosting, and streaming only.
Jentic publishes the only available OpenAPI specification for Gumlet API, keeping it validated and agent-ready. Gumlet is a cloud media platform that ingests, transcodes, and streams video and image content with support for live streaming, adaptive bitrate playback, subtitles, audio tracks, watermarks, and analytics. Its REST API spans 64 operations covering video assets, image sources, live broadcasts, playlists, encoding profiles, webhooks, and workspace management. Authentication is via bearer token tied to a Gumlet workspace.
Configure live streaming endpoints and capture playlists for broadcast workflows
Manage image sources and encoding profiles per workspace
Register webhooks to receive transcoding and live-stream events
Patterns agents use Gumlet API for, with concrete tasks.
★ Programmatic video ingestion pipeline
Build an upload pipeline that pushes user-generated or studio-produced videos into Gumlet, polls until adaptive-bitrate transcoding completes, and stores the resulting playback URL on the source record. The Direct Upload endpoint avoids buffering through your servers, and webhooks signal completion. Most video assets are ready for streaming within minutes of upload completing.
Call POST /video/assets/upload to obtain a direct upload URL for a 1080p MP4 file, then poll GET /video/assets/{asset_id} until status is 'ready'.
Subtitle and audio track localisation
Localise streamed video by uploading subtitle files in multiple languages and alternate audio tracks per asset. The asset endpoints accept WebVTT and SRT subtitles and audio tracks bound to a language code, which Gumlet then exposes during playback. Suitable for OTT platforms shipping multilingual catalogues.
Upload an English WebVTT file via POST /video/assets/{asset_ID}/subtitle/upload and confirm completion with the matching upload event endpoint.
Live stream control plane
Configure live streaming for sports, events, or webinars with Gumlet by creating a live stream object, retrieving the RTMP ingest URL and stream key, then capturing the resulting playlist when the broadcast ends. The API exposes asset and playlist resources that turn the recorded stream into an on-demand asset for replay.
Create a live stream resource, return the ingest URL and stream key, and store the recorded asset ID once the broadcast ends.
AI agent media uploader via Jentic
An AI agent receives a request to publish a marketing video, uploads the source file to Gumlet, generates a thumbnail at the 5-second mark, and registers a webhook so the calling system is notified when transcoding finishes. Through Jentic the agent calls the right endpoints without browsing Gumlet's docs.
Search Jentic for 'upload a video to gumlet', load the POST /video/assets/upload schema, and execute it with the source URL and a thumbnail at 5 seconds.
64 endpoints — jentic publishes the only available openapi specification for gumlet api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/video/assets
Create a video asset
/video/assets/upload
Create a direct-upload video asset
/video/assets/{asset_id}
Get video asset details
/video/assets/{asset_id}
Delete a video asset
/video/assets/{asset_id}/thumbnail
Generate a thumbnail from a video
/video/assets/{asset_ID}/subtitle/upload
Upload a subtitle file
/video/assets
Create a video asset
/video/assets/upload
Create a direct-upload video asset
/video/assets/{asset_id}
Get video asset details
/video/assets/{asset_id}
Delete a video asset
/video/assets/{asset_id}/thumbnail
Generate a thumbnail from a video
Three things that make agents converge on Jentic-routed access.
Credential isolation
Gumlet bearer keys are stored encrypted in the Jentic vault. Agents receive scoped execution tokens — the workspace API key never enters the agent's context window.
Intent-based discovery
Agents search Jentic by intent (e.g., 'upload a video to gumlet') and Jentic returns the matching Gumlet operation with its input schema, including direct-upload and subtitle endpoints.
Time to first call
Direct integration: 1-3 days to wire upload, polling, webhook handling, and error recovery. Through Jentic: under an hour — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Gumlet API through Jentic.
Why is there no official OpenAPI spec for Gumlet API?
Gumlet does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Gumlet API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Gumlet API use?
Gumlet uses HTTP bearer authentication. You pass the workspace API key as Authorization: Bearer <key>. Through Jentic, the key is stored in the encrypted vault and only scoped tokens are passed to the executing agent.
Can I upload a video directly without proxying through my servers with the Gumlet API?
Yes. Call POST /video/assets/upload to receive a signed direct-upload URL, then PUT the video file straight to that URL. The asset record then transitions through processing states tracked at GET /video/assets/{asset_id}.
Can I add subtitles and alternate audio tracks to a Gumlet asset?
Yes. POST /video/assets/{asset_ID}/subtitle/upload accepts WebVTT or SRT files, and POST /video/assets/{asset_ID}/audio/upload accepts alternate audio tracks. Both endpoints have a matching event endpoint to mark the upload complete.
How do I get notified when a Gumlet asset finishes transcoding?
Register a webhook through the workspace webhook endpoints with an event subscription for video asset state changes. Gumlet then POSTs the asset payload to your URL when transcoding completes.
How do I upload a video to Gumlet through Jentic?
Search Jentic for 'upload a video to gumlet', load the POST /video/assets/upload operation schema, then execute with the source URL or file pointer. Install with pip install jentic.
/video/assets/{asset_ID}/subtitle/upload
Upload a subtitle file