VIDEO

Base-Path:

https://api.hyprlab.io/v1

Video Path:

https://api.hyprlab.io/v1/video/generations

👉🏻 Request Body Documentation

prompt (string, required)

• Description: The main text input that guides the video generation.

• Validation:

  • Must be a non-empty string.

duration (integer, optional)

• Description: Specifies the length of the video in seconds.

• Validation:

  • Must be one of: 5, 6, 7, or 8.

  • Defaults to 5 if not provided.

image (string, required)

• Description: Input image to start generating from.

• Validation:

  • Must be a valid URI

aspect_ratio (string, optional)

• Description: Video aspect ratio.

• Validation:

  • Must be one of: "16:9" or "9:16".

  • Defaults to "16:9" if not provided.

Post Request:

When you send a POST request to create a new Video Generation, the API will return a response containing a Polling URL that can be used to check the processing status and retrieve the results.

curl https://api.hyprlab.io/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HYPRLAB_API_KEY" \
  -d '{
    "model": "veo-2",
    "prompt": "A playful and adorable cat is surrounded by tall trees and blooming flowers.",
    "image": "https://site.com/path/of/image.png",
    "duration": 5
    "aspect_ratio": "16:9",
  }'

// Sample Response:
{
  "created": 123,
  "id": "abc123",
  "data": [
    {
      "url": "https://api.hyprlab.io/v1/video/result/123-abc123"
    }
  ]
}

---

Polling for Status:

To check the status and retrieve the result, send a GET request to the polling URL provided in the response.

curl -X GET "https://api.hyprlab.io/v1/video/result/123-abc123" \
  -H "Authorization: Bearer $HYPRLAB_API_KEY" \
  -H "Accept: application/json"

NOTE: Video Generation took 3-4 Minutes before it finish.

Success Status:

{
  "created": 123,
  "data": [
    {
      "url": "https://pub-abc123.r2.dev/123-abc123.mp4"
    }
  ]
}

Processing Status:

{
  "status": "processing",
  "message": "Video is still being processed.."
}

Failed Status:

{
  "error": {
    "message": "Video processing failed.",
    "type": "processing_error",
    "param": null,
    "code": "processing_failed"
  }
}

🎥 Google Video Models

Model Name:

• veo-2

Discount:

• 20% off

Price:

• 5 Seconds: $2 / Video

• 6 Seconds: $2.4 / Video

• 7 Seconds: $2.8 / Video

• 8 Seconds: $3.2 / Video