Logo

Command Palette

Search for a command to run...

Integrations

Using the Revid AI API

Automate video creation with the Revid AI API

The Revid AI API allows you to programmatically generate videos, enabling you to build automated content workflows. By integrating Revid AI into your applications or automation tools like Make.com, you can scale your video production without manual intervention.

The Revid AI API is currently in Beta. Access to the API requires a subscription to the Growth plan.

Authentication

To use the API, you need to authenticate your requests using an API key. This key identifies your account and authorizes your applications to create videos on your behalf.

Generating your API Key

  1. Log in to your Revid AI account.

  2. Navigate to your Account Settings.

  3. Look for the API Key section.

  4. Click to generate a new key.

  5. Copy the key immediately and store it in a secure location. You will need this for every API request.

Using the API Key

Include your API key in the header of your HTTP requests. The header name should be key.

key: your_api_key_here

API Endpoints

The primary endpoint for generating videos is the render endpoint. This endpoint accepts a configuration object defining the video content and settings.

Create a Video

Endpoint: POST https://www.typeframes.com/api/public/v2/render

This request initiates the video rendering process. Because video generation can take several minutes, this endpoint is asynchronous. It will return immediately, and the final video details will be sent to your specified webhook URL once processing is complete.

Request Body Parameters

  • webhook (string, required): The URL where Revid AI will send the result once the video is ready.

  • frameRate (number): Frames per second (default: 60).

  • resolution (string): Video resolution (default: "720p").

  • creationParams (object): The core content definitions.

    • inputText: The prompt or script for the video.

    • flowType: The type of generation (e.g., "text-to-video").

    • slug: A unique identifier slug (e.g., "create-tiktok-video").

    • ratio: Aspect ratio (e.g., "9 / 16" for vertical videos).

Example Request

{ "webhook": "https://your-domain.com/webhook-endpoint", "frameRate": 60, "resolution": "1080p", "creationParams": { "inputText": "Top 5 travel destinations for 2024", "flowType": "text-to-video", "ratio": "9 / 16" } }

Webhooks

Since video rendering is not instantaneous, webhooks are essential for receiving the final video URL. When you make a request to the render endpoint, you must provide a webhook URL.

Once the video is successfully generated (which may take up to 10 minutes depending on complexity), Revid AI will send a POST request to your webhook URL containing:

  • The status of the job.

  • The direct download URL of the generated video.

You can use services like Webhook.site to test your webhook integration and inspect the payload structure before building your production listener.

Make.com Integration

You can integrate Revid AI directly into your Make.com (formerly Integromat) workflows to automate video creation without writing code.

The Make.com integration is a community-developed app by Codex Solutions International. It requires a separate Access Code to use.

Setting up the Integration

  1. Go to the Revid AI integration page on Make.com and click Install.

  2. Obtain your Access Code from Codex Solutions.

  3. In your Make.com scenario, add a Revid AI module.

  4. When prompted for a connection, enter your Access Code and your Revid AI API Key.

Available Modules

  • Create a TikTok Video: Generate a new video from text.

  • Get a Video Status: Check if a video has finished rendering.

  • List All Projects: Retrieve a list of your video projects.

  • Publish a Video: Automatically publish a generated video.

For a visual guide on setting this up, you can watch the tutorial by Codex Solutions.