Create Video /v2/videos/creations

Creating a Video

Endpoint

Base URL: https://backend.blotato.com/v2

URL: /videos/creations

Method: POST

Description

This endpoint allows users to create a new video from a script, style and template.

Request

Request Body

The request body must contain the following fields:

Field	Type	Required	Description
template	object	✅	Template specification. the id field must match exactly.
script	string	✅	The timestamp (ISO 8601) when the post should be published.
style	string	✅	Style e.g. 'horror', 'cinematic', etc.
animateFirstImage	boolean	❌	Default: false. If true, the first image will be animated with Kling 1.6 pro model. Note that insufficient credits will result in the model not being animated.

template Object

Field	Type	Required	Description
id	'base/pov/wake-up' | 'empty'	✅	The ID of the template to use.

Responses

Success Response

Status Code: 201 Created

Video creation is scheduled on the queue. To see the status, poll the Find Video endpoint.

Response Body:

{
  "item": {
    "id": "VIDEO ID",
    "status": "Queued"
  },
}

Error Responses

Too Many Requests

Post creation has a user-level rate limit of 1 request / minute to prevent spamming / abusing video creation.

Status Code: 429 Too many requests

{
  "statusCode": 429,
  "message": "Rate limit exceeded, retry in 49 seconds"
}

Examples

1. Create a POV video

POST https://backend.blotato.com/v2/posts HTTP/1.1
Content-Type: application/json
Headers:

{
  "script": "you wake up as a pharaoh",
  "style": "cinematic",
  "template": {
    "id": "base/pov/wake-up",
  }
}

Troubleshooting

If you are having troubles generating the video, or it's taking too long, navigate to https://my.blotato.com/videos/<YOUR_VIDEO_ID> to view the image / video and manually edit it.