Free live streaming and video API: what the Free plan includes
The DCAST Partner API has no separate API plan. Anyone who signs up, the Free plan included, can create a key and call the operations; the plan of the account decides how much you can run, and the same limits apply in the dashboard and in the API. This page lists what the Free plan includes, read from the server, and the calls that show the limits of your own account.
GET /me (plan, planLimits) and GET /quota (storage). A call that reaches a limit answers with a code that names it.What the Free plan includes
Every value in this table is read from the plan data of the DCAST server when the page is rendered. None is typed by hand; a dash means the server could not be reached for this render.
| Limit | Free plan |
|---|---|
| Video storage | 10 GB |
| Uploaded video quality | 720p, up to 120 fps |
| Live quality | 720p, up to 60 fps |
| Streams at once | 1 |
| Viewers per stream | 50 |
| Length of one live session | 1 h |
| Live time per month (streams, restreams and rooms together) | 10 h |
| Restream destinations at once | 2 |
| Participants in a room | 10 |
| Rooms at once | 1 |
| Length of one room | 30 min |
Star, Pro and VIP raise these numbers. Every plan side by side is on pricing, and the numbers the API enforces are also listed in Errors & limits.
Read the limits of your own account
GET /me answers with plan and planLimits, the same object the dashboard reads, so an integration finds its ceilings and feature flags without waiting for a refusal. GET /quota answers with the storage used against the limit. GET /health needs no key.
| Call | Auth | What you get |
|---|---|---|
GET /health | public | The state of the API: data.status reads healthy when it is up. |
GET /me | key | plan, planLimits and embedAllowlist, with the full profile. |
GET /quota | key | Storage used, limit and available in bytes, plus usedPercent and isExceeded. |
GET /changelog | public | The dated list of changes to the API, so an integration notices a change. |
curl -s "https://api.dcast.pro/api/v1/health"
# → data.status
curl -s -H "Authorization: Bearer pk_YOUR_KEY_HERE" "https://api.dcast.pro/api/v1/me"
# → data.plan, data.planLimits
curl -s -H "Authorization: Bearer pk_YOUR_KEY_HERE" "https://api.dcast.pro/api/v1/quota"
# → data.used, data.limit, data.available (bytes), data.usedPercent, data.isExceededWhen a limit is reached
The call is refused with an error code that names the limit: for example PLAN_STREAM_LIMIT_REACHED (409) for streams at once, PLAN_RESTREAM_LEG_LIMIT_REACHED (409) for restream destinations and QUOTA_EXCEEDED (403) for storage. The codes are listed in Errors & limits. Do not retry the same call: move the account to a larger plan or free some room.
Your first calls on the Free plan
- Sign up on dcast.pro, open Settings → API Keys in the dashboard and create a key.
- Read your plan and limits with
GET /meandGET /quota. - Create a stream with
POST /streamsand put it on a page as shown in Embed a live stream. - Upload a video with
POST /videos/uploadand show your library as shown in Video website.
For AI agents
Connect the DCAST MCP server at https://api.dcast.pro/mcp. Each tool is one API operation, and dcast_get_recipe returns the exact tool-call sequence for a job.
Before promising anything to the person, call get_account for the plan and limits and get_storage_quota for the storage. A plan limit names itself in the error: tell the person which limit it is, ask dcast_search_docs which plan raises it, and do not retry the call.
Never ask the person to create, copy or paste an API key. If the website's own server must call DCAST, call ask_site_access: the person clicks one Allow link and the key goes straight into the site's environment. You never see it.
