video-01

This documentation is valid for the following list of our models:

• video-01

Try in Playground

An innovative AI model designed for generating high-quality videos from text prompts or image. Developed by Hailou AI, this model can produce visually striking content with cinematic qualities, allowing users to create engaging videos quickly and efficiently.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

How to Make a Call

Step-by-Step Instructions

Generating a video using this model involves sequentially calling two endpoints:

• The first one is for creating and sending a video generation task to the server (returns a generation ID).

• The second one is for requesting the generated video from the server using the generation ID received from the first endpoint.

Below, you can find two corresponding API schemas.

API Schemas

Create a video generation task and send it to the server

post

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Body

application/json

modelundefined · enumRequiredPossible values:

promptstring · max: 2000Required

The text description of the scene, subject, or action to generate in the video.

first_frame_imagestring · uriOptional

A direct link to an online image or a Base64-encoded local image that will serve as the first frame for the video. Image specifications:

• format must be JPG, JPEG, or PNG;
• aspect ratio should be greater than 2:5 and less than 5:2;
• the shorter side must exceed 300 pixels;
• file size must not exceed 20MB.

prompt_optimizerbooleanOptional

If True, the incoming prompt will be automatically optimized to improve generation quality when needed. For more precise control, set it to False — the model will then follow the instructions more strictly.

Default: true

Responses

200

Successfully generated video

application/json

post

/v2/generate/video/minimax/generation

JavaScriptPythoncURLHTTP

async function main() {
  const response = await fetch('https://api.aimlapi.com/v2/video/generations', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <YOUR_API_KEY>',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "model": "video-01",
      "prompt": "A menacing evil dragon appears in a distance above the tallest mountain, then rushes toward the camera with its jaws open, revealing massive fangs. We see it's coming."
    }),
  });

  const data = await response.json();
  console.log(JSON.stringify(data, null, 2));
}

main();

200

Successfully generated video

{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4",
    "duration": 8
  },
  "duration": 8,
  "error": null,
  "meta": {
    "usage": {
      "tokens_used": 120000
    }
  }
}

Retrieve the generated video from the server

After sending a request for video generation, this task is added to the queue. This endpoint lets you check the status of a video generation task using its id, obtained from the endpoint described above. If the video generation task status is complete, the response will include the final result — with the generated video URL and additional metadata.

get

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Query parameters

generation_idstringRequired

Generation ID

Example: 222226666699999

Responses

200

Successfully generated video

application/json

get

/v2/generate/video/minimax/generation

HTTPcURLJavaScriptPython

GET /v2/generate/video/minimax/generation?generation_id=222226666699999 HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Successfully generated video

{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4",
    "duration": 8
  },
  "duration": 8,
  "error": null,
  "meta": {
    "usage": {
      "tokens_used": 120000
    }
  }
}