Skip to main content
POST
/
videos
/
generate
curl --request POST \ --url https://api.smartlyq.com/v1/videos/generate \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "kling-v2-1", "type": "text_to_video", "prompt": "A lone astronaut walks across a crimson desert at sunset", "duration": 10, "mode": "Professional", "aspect_ratio": "16:9" } '
{
  "success": true,
  "data": {
    "job_uid": "job_a1b2c3d4e5f6",
    "status": "queued"
  },
  "usage": {
    "units": 1,
    "cost": "0.2800",
    "balance_remaining": "14.7200"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.smartlyq.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key from Developer dashboard (Bearer token).

Body

application/json
​
model
string
required

Model identifier. See GET /v1/videos/models for available values.

Example:

"kling-v2-1"

​
type
enum<string>
required

Generation mode. text_to_video requires prompt. image_to_video requires image_url; prompt is optional motion guidance.

Available options:
text_to_video,
image_to_video
Example:

"text_to_video"

​
prompt
string

Text description of the video. Required for text_to_video. Optional for image_to_video. Max length varies per model — see prompt_max_length in /v1/videos/models.

Example:

"A lone astronaut walks across a crimson desert at sunset"

​
image_url
string<uri>

Source image URL for image_to_video. Must be a publicly accessible JPEG or PNG.

Example:

"https://example.com/my-image.jpg"

​
duration
integer

Video length in seconds. Valid values vary per model — see duration in /v1/videos/models. Defaults to the shortest valid duration.

Example:

10

​
resolution
string

Output resolution (e.g. 720p, 1080p). Valid values vary per model — see resolution in /v1/videos/models.

Example:

"1080p"

​
mode
string

Generation quality mode (e.g. Standard, Professional, Fast). Valid values vary per model — see mode in /v1/videos/models.

Example:

"Professional"

​
aspect_ratio
string

Output aspect ratio (e.g. 16:9, 9:16, 1:1). Valid values vary per model — see aspect_ratio in /v1/videos/models.

Example:

"16:9"

​
style
string

Visual style preset (e.g. Anime, Cyberpunk). Only supported by some models — see style in /v1/videos/models.

Example:

"Anime"

​
movement
string

Camera/subject movement amplitude (Auto, Small, Medium, Large). Only supported by some models — see movement in /v1/videos/models.

Example:

"Medium"

​
negative_prompt
string

Elements to suppress in the output. Only supported by some models — see supports_negative_prompt in /v1/videos/models.

Example:

"blurry, low quality, watermark"

​
seed
integer

Reproducibility seed. Only supported by some models — see supports_seed in /v1/videos/models.

Example:

42

​
generate_audio
boolean

Generate ambient audio alongside the video. Only supported by some models — see supports_generate_audio in /v1/videos/models.

Example:

false

​
camera_fixed
boolean

Lock the camera position (no camera movement). Only supported by some models — see supports_camera_fixed in /v1/videos/models.

Example:

false

Response

Accepted — poll GET /v1/jobs/{job_uid} for result

​
success
enum<boolean>
Available options:
true
​
data
object
​
usage
object
​
meta
object