Skip to main content
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.zarkai.xyz/v1/videos/generations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "prompt": "A serene lake at sunrise with mist rolling over the water",
  "workspace_id": "wks-xxxxx"
}
'
{
  "request_id": "41eb9a5f-cbd4-9f21-8d59-79005f1e61b7"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication

Body

application/json
​
prompt
string
required

Text description of the video to generate

​
workspace_id
string
required

Your Space ID

​
file_id
string

Optional file ID of a source image to animate (image-to-video)

​
duration
integer

Target duration in seconds

​
aspect_ratio
string
default:16:9

Output aspect ratio (e.g. 16:9, 9:16, 1:1)

Response

Video generation started

​
request_id
string

Unique request ID to poll for results