APIs

The kit comes with API routes to render remotion videos, fetch progress, and callback webhooks.

Render API

The render API is used to render the video. It is a POST request that takes the composition name and the input props.

POST /api/remotion/render

This is a protected route by default. You need to pass the Authorization header with the value Bearer <token>.

  • props - The input props for the composition.
  • composition - The composition name.
  • codec - The codec to use for the video.
  • projectId - The project ID.

Progress API

The progress API is used to fetch the progress of the render. It is a GET request that takes the render ID.

GET /api/remotion/render/{id}

It is a protected route by default.

Webhook API

The webhook API is used to listen to the webhook callbacks from the render lambda fuction. It already handles most of the scenarios. It does following things:

  • Update the status of the render in the database
  • Cosume the credit for the user

MIT 2025 Β© Nextra.