VIDEO

Base-Path:

https://api.hyprlab.io/v1

Video Path:

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

📌 VEO 3.1 - Request Body Documentation

prompt (string, required)

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

• Validation:

  • Must be a non-empty string.

image (string, optional)

• Description: Input image to start generating from.

• Validation:

  • Must be a URL, Data URI, or base64 string.

last_frame (string, optional)

• Description: Ending image for interpolation.

• Validation:

  • Must be a URL, Data URI, or base64 string.

reference_images (string / array, optional)

• Description: Reference to Video (only work with 16:9 aspect ratio).

• Validation:

  • Must be a URL, Data URI, or base64 string.

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.

resolution (string, optional)

• Description: Resolution of the generated video.

• Validation:

  • Must be one of: "720p" or "1080p".

  • Defaults to "720p" if not provided.

negative_prompt (string, optional)

• Description: A prompt meant to negatively influence or guide processing to not include specific elements.

• Validation:

  • Must be a text/string.

seed (integer, optional)

• Description: A seed for deterministic generation during processing.

• Validation Rules:

  • Must be an integer between 0 and 4,294,967,295.

📌 VEO 3 - Request Body Documentation

prompt (string, required)

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

• Validation:

  • Must be a non-empty string.

image (string, optional)

• Description: Input image to start generating from.

• Validation:

  • Must be a URL, Data URI, or base64 string.

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.

resolution (string, optional)

• Description: Resolution of the generated video.

• Validation:

  • Must be one of: "720p" or "1080p".

  • Defaults to "720p" if not provided.

negative_prompt (string, optional)

• Description: A prompt meant to negatively influence or guide processing to not include specific elements.

• Validation:

  • Must be a text/string.

seed (integer, optional)

• Description: A seed for deterministic generation during processing.

• Validation Rules:

  • Must be an integer between 0 and 4,294,967,295.

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.

Text Prompt:

curl https://api.hyprlab.io/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HYPRLAB_API_KEY" \
  -d '{
    "model": "veo-3.1",
    "prompt": "A playful and adorable cat.",
    "aspect_ratio": "16:9",
  }'

Image:

Image & Last Frame:

Reference Images:

// 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:

Failed Status:

🎥 Veo Models

Model Name:

• veo-3.1

Discount:

• 50% off

Price:

• 8 Seconds: $1.6 / Video

Model Name:

• veo-3.1-fast

Discount:

• 50% off

Price:

• 8 Seconds: $0.6 / Video

Model Name:

• veo-3

Discount:

• 50% off

Price:

• 8 Seconds: $1.6 / Video

Model Name:

• veo-3-fast

Discount:

• 50% off

Price:

• 8 Seconds: $0.6 / Video