Coconut Video Encoding API

Name: Coconut Video Encoding API
Brand: Coconut Video Encoding API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaVideo Processingbasic4 EndpointsREST

For Agents

Submit cloud video transcoding jobs that output MP4, HLS, and DASH, then read back job status and per-output metadata.

Install Jentic One Beta

Connect the Coconut Video Encoding API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Coconut Video Encoding 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 | sh

Step 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 instance

Jentic 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.

Capabilities

What an agent can do with Coconut Video Encoding API.

Submit transcoding jobs that fan out to MP4, HLS, and DASH outputs via POST /jobs

Poll the status of a transcoding job via GET /jobs/{jobId}

Retrieve full job metadata — duration, resolution, codecs, output URLs — via GET /metadata/jobs/{jobId}

GET STARTED

Start building with Coconut Video Encoding API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Coconut Video Encoding API, keeping it validated and agent-ready. The API runs cloud video transcoding jobs that accept a source URL and a job specification, then output to formats including MP4, HLS, and DASH for adaptive streaming. After submission a job can be polled for status and inspected for output-level metadata such as duration, resolution, and codec. Coconut runs in three regions — North Virginia, Oregon, and Ireland — and authenticates with HTTP Basic where the API key is sent as the username.

Use Cases

Patterns agents use Coconut Video Encoding API for, with concrete tasks.

★ On-Demand Video Library Encoding

Convert a creator-uploaded master video into web-ready MP4s plus an HLS ladder for adaptive playback on mobile and desktop. POST /jobs accepts the source URL and a job specification listing each output, GET /jobs/{jobId} reports progress, and GET /metadata/jobs/{jobId} returns the URLs and technical detail for every rendition once the job finishes. End-to-end integration takes well under a day.

Submit POST /jobs with an MP4 source and an HLS 1080p/720p/480p output spec, then poll GET /jobs/{jobId} until status is completed.

DASH Streaming Output for Live VOD

Generate DASH segments and a manifest for a video-on-demand archive backed by a player that prefers DASH. The Coconut job spec accepts DASH outputs alongside MP4 and HLS, and GET /metadata/jobs/{jobId}/{outputKey} returns the per-output technical detail so the front-end can render quality switches and bitrate badges accurately.

Submit a DASH output spec via POST /jobs and then call GET /metadata/jobs/{jobId}/dash_main to read the resulting manifest details.

Multi-Region Encoding for Latency-Sensitive Workloads

Route encoding jobs to the closest Coconut region — North Virginia, Oregon, or Ireland — to reduce upload time and stay within data residency boundaries. The base URL for each region is published in the spec, so a workflow that pulls source video from EU storage can submit the job to the Ireland endpoint and write outputs back into the same region.

Submit POST https://api-eu-west-1.coconut.co/v2/jobs with an EU-hosted source and EU-hosted output URL.

AI Agent Video Workflows via Jentic

An AI assistant in a media operations workflow uses Jentic to submit encoding jobs without holding the Basic auth API key. The agent searches for 'transcode a video to HLS', loads the schema, and executes — Jentic injects the API key as the username component of the Basic header at execution time so the agent never sees the secret.

Use Jentic to search for 'transcode a video to HLS', load the POST /jobs schema, and submit a job for source URL https://example.com/master.mp4.

Key Endpoints

4 endpoints — jentic publishes the only available openapi specification for coconut video encoding api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/jobs

Submit a transcoding job

GET

/jobs/{jobId}

Get job status

GET

/metadata/jobs/{jobId}

Read full metadata for a job

GET

/metadata/jobs/{jobId}/{outputKey}

Read metadata for a single output

POST

/jobs

Submit a transcoding job

GET

/jobs/{jobId}

Get job status

GET

/metadata/jobs/{jobId}

Read full metadata for a job

GET

/metadata/jobs/{jobId}/{outputKey}

Read metadata for a single output

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Coconut API key is stored encrypted in the Jentic vault. Jentic assembles the Basic auth header (api key as username, empty password) at execution time, so an agent never holds the raw credential or has to encode it.

Intent-based discovery

Agents search by intent (e.g. 'transcode a video to HLS' or 'check encoding job status') and Jentic returns the matching Coconut operation with its parameter schema, so the agent can construct a valid job spec without reading the docs.

Time to first call

Direct Coconut integration: half a day to wire up Basic auth, the job spec format, and status polling. Through Jentic: under one hour — search, load schema, execute.

FAQs

Specific to using Coconut Video Encoding API through Jentic.

Why is there no official OpenAPI spec for Coconut Video Encoding API?

Coconut publishes prose documentation at docs.coconut.co but does not provide an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Coconut Video Encoding 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 Coconut Video Encoding API use?

The API uses HTTP Basic authentication. Send the Coconut API key as the username and leave the password blank. Through Jentic the API key is stored encrypted in the vault and assembled into the Authorization header at execution time.

Can I generate HLS and DASH outputs in a single Coconut job?

Yes. POST /jobs accepts a job specification that lists multiple outputs, including MP4, HLS, and DASH variants in the same submission. Each output is reported separately in the metadata so a front-end player can pick the right manifest at runtime.

What are the rate limits for the Coconut Video Encoding API?

The OpenAPI spec does not declare numeric rate limits. Coconut applies plan-based concurrency caps on simultaneous jobs, so a high-volume pipeline should track in-flight job ids and throttle new POST /jobs calls until earlier jobs report status completed.

How do I check whether a transcoding job has finished through Jentic?

Search Jentic for 'check Coconut job status', load the GET /jobs/{jobId} schema, and execute with the job id returned by POST /jobs. Install the SDK with pip install jentic and call it via the async client. The response includes status (pending, processing, completed, or failed) and the underlying error if the job failed.

Can I run jobs in EU regions for data residency?

Yes. The spec lists three server URLs — https://api.coconut.co/v2 (North Virginia), https://api-us-west-2.coconut.co/v2 (Oregon), and https://api-eu-west-1.coconut.co/v2 (Ireland). Pick the EU base URL when source storage and output destinations are also in the EU.