curl --request POST \
  --url https://api.modellix.ai/api/v1/skywork/segmented-camera-motion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A woman singing in a recording studio",
  "first_frame_image": "https://example.com/portrait.png",
  "audios": [
    "https://example.com/voice.wav"
  ],
  "traj_type": "push_in"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-skyreels-camera-001",
    "model_id": "skyreels/segmented-camera-motion",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-skyreels-camera-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

SkyReels Segmented Camera Motion

**[Core Function]** SkyReels Segmented Camera Motion (audio-to-video) generates a talking-avatar video with directed camera movement across time segments. **[Strengths]** Combines an audio-driven avatar with per-segment camera trajectories such as push, pan, crane and rotation. **[Best For]** Dynamic presenter clips and cinematic avatar shots with controlled camera motion. **[Limitations]** Do NOT use this when you need a completely static camera (use single-actor-avatar). It requires first_frame_image and one audio segment; use camera_control_pro for multi-segment or compound moves. mode=std outputs 720p, mode=pro outputs 1080p. **[Routing]** Set a single traj_type plus camera_control_strength for a simple move, or supply camera_control_pro (a list of per-segment {start_time, end_time, traj_type, ...}) for compound motion; choose mode=pro for 1080p.

POST

skywork

segmented-camera-motion

curl --request POST \
  --url https://api.modellix.ai/api/v1/skywork/segmented-camera-motion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A woman singing in a recording studio",
  "first_frame_image": "https://example.com/portrait.png",
  "audios": [
    "https://example.com/voice.wav"
  ],
  "traj_type": "push_in"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-skyreels-camera-001",
    "model_id": "skyreels/segmented-camera-motion",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-skyreels-camera-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

SkyReels segmented camera-motion request (image + audio + camera trajectories).

prompt

string

required

Text description of the video (max 512 tokens).

Minimum string length: 1

Example:

"A woman singing in a recording studio"

first_frame_image

string

required

Portrait image URL (jpg/jpeg/png/gif/bmp).

Minimum string length: 1

Example:

"https://example.com/portrait.png"

audios

string[]

required

Exactly one audio URL (mp3/wav, each segment <=200s).

Required array length: 1 element

Minimum string length: 1

Example:

["https://example.com/voice.wav"]

traj_type

enum<string>

Single camera trajectory; omit to leave unspecified. Takes effect together with camera_control_strength when camera_control_pro is not used.

Available options:

static,

push_in,

push_out,

pan_left,

pan_right,

crane_up,

crane_down,

swing,

left_rotation,

right_rotation

Example:

"push_in"

camera_control_strength

number

default:0.8

Strength of the single camera trajectory.

Required range: 0 <= x <= 1

Example:

0.8

camera_control_pro

object[]

Per-segment compound camera motion. When provided, overrides the single traj_type.

Show child attributes

mode

enum<string>

default:std

Output mode: std returns 720p, pro returns 1080p.

Available options:

std,

pro

Example:

"std"

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Single actor avatar Skyreels omni