Beginner's Guide to Video Generation with Allegros API

Beginner's Guide to Video Generation with Allegro's API

Hello! Tommy here, and today I'm excited to introduce you to Allegro's API for video generation by Rhymes AI. This tutorial will walk you through setting up the API, making requests, and receiving high-quality video output—all in real time using Google Colab. I'll also provide a Colab notebook link so you can easily test the API hands-on.

Whether you're curious about how text prompts can bring videos to life or looking to start your journey in automated video content creation, this tutorial will walk you through everything you need to get started while keeping it fun and accessible.

Let's dive into the world of video generation!

Step 1: Setting Up Your API Token

Start by storing your Allegro API token securely in Google Colab by setting it as an environment variable. This is critical for authentication and ensuring secure access to the API.

Step 2: Creating a Video Task

Next, create a video task with the following Python function. Note that Allegro's API expects a refined prompt, the original user prompt, and several other parameters. Here's the code to initiate the video generation task:

import requests

# Function to create a video task

def create_video_task(api_token, refined_prompt, user_prompt, num_step=100, cfg_scale=7.5, rand_seed=None):
    url = "https://api.allegro.com/video/generate"
    headers = {"Authorization": f"Bearer {api_token}", "Content-Type": "application/json"}
    data = {
        "refined_prompt": refined_prompt,
        "user_prompt": user_prompt,
        "num_step": num_step,
        "cfg_scale": cfg_scale,
        "rand_seed": rand_seed
    }
    response = requests.post(url, headers=headers, json=data)
    return response.json()

Explanation of Parameters:

• refined_prompt: A refined version of your initial prompt (must be at least 8 words).
• num_step: Defines the number of inference steps (default is 100 for quality).
• cfg_scale: Controls video quality (recommended default of 7.5).
• rand_seed: Ensures consistent output with the same seed value.
• user_prompt: Original prompt provided by the user.

Upon execution, you should see output like this: The data field provides the requestId, which you'll use to track the status of your video task.

Using curl for Command-Line Users

For users who prefer the command line, here's how you can create the video task using curl:

curl -X POST https://api.allegro.com/video/generate \
-H "Authorization: Bearer your_allegro_api_token_here" \
-H "Content-Type: application/json" \
-d '{"refined_prompt":"Your refined prompt goes here",
      "user_prompt":"Your original prompt",
      "num_step":100,
      "cfg_scale":7.5,
      "rand_seed":"optional_seed"}'

Step 3: Querying the Video Task Status

Wait at least two minutes before querying the task status, as the video processing may take some time. Here's the code to check whether the video is ready:

def check_video_status(api_token, request_id):
    url = f"https://api.allegro.com/video/status/{request_id}"
    headers = {"Authorization": f"Bearer {api_token}"}
    response = requests.get(url, headers=headers)
    return response.json()

The output will include a link to the video in the data field if it's ready:

{"data": {"video_url": "link_to_your_video"}}

If the video is not yet ready, you'll see:

{"data": {}} // Empty data field

Using curl for Command-Line Users

To check the status of your video task via curl, use the following:

curl -X GET https://api.allegro.com/video/status/{request_id} \
-H "Authorization: Bearer your_bearer_token_here"

Replace your_bearer_token_here and data-value-from-creating-video-task with your actual values. If the video is ready, the data field will contain a link to the video file stored on an S3 bucket. If not, it will return an empty data field.

Using these curl commands, you can create and track video tasks directly from your terminal, making Allegro's API accessible for command-line automation or testing.

Find the link to the Google Colab Notebook

For this tutorial, you can access the practical example through this Google Colab notebook.

Conclusion

Congratulations! You've successfully created and tracked a video generation task using Allegro's API. Through this guide, you learned to make API requests, set up parameters, and handle responses, taking you from prompt input to a ready-to-watch video output. Allegro's API makes video generation simple, letting you create dynamic, high-quality videos from text prompts in just a few steps.

Using this workflow, you can experiment with different prompts and settings, producing video content quickly and efficiently. This setup is ideal for prototyping, social media content, or any scenario where you need short, customized video clips.

For more Advanced API documentation, check out this PDF.

As you continue to explore Allegro's capabilities, remember that the possibilities are endless—so keep experimenting, and let your creativity shape your next big idea!