curl --request POST \
  --url https://api.modellix.ai/api/v1/skywork/skyreels-i2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "The man slowly turns toward the camera and smiles"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-skyreels-i2v-001",
    "model_id": "skyreels/skyreels-i2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-skyreels-i2v-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 Image-to-Video

[Core Function] SkyReels Image-to-Video animates one or more keyframe images into a video guided by a text prompt. [Strengths] Supports a start frame, an end frame, and tagged mid-frames for keyframe control; optional audio, 480p/720p/1080p output, and fast/std modes. [Best For] Bringing a photo to life, first-last-frame transitions, and keyframe-driven storyboards. [Limitations] Do NOT use this for pure text-to-video (use skyreels-t2v) or for editing an existing video (use the Omni / video-to-video models). It requires at least one of first_frame_image, end_frame_image, or mid_frame_images; output is capped at 1080p and 15s, and fast mode supports only sound=false. [Routing] Provide first_frame_image to animate from a start image, add end_frame_image for a transition, or supply mid_frame_images (each tag must appear in the prompt as @tag) for keyframe guidance.

POST

/

skywork

/

skyreels-i2v

curl --request POST \
  --url https://api.modellix.ai/api/v1/skywork/skyreels-i2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "The man slowly turns toward the camera and smiles"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-skyreels-i2v-001",
    "model_id": "skyreels/skyreels-i2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-skyreels-i2v-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 image-to-video request. prompt is required; at least one of first_frame_image, end_frame_image, or mid_frame_images must be provided. Other fields fall back to provider defaults.

prompt

string

required

Text description of the video to generate (max 1280 tokens).

Minimum string length: 1

Example:

"The man slowly turns toward the camera and smiles"

first_frame_image

string

Start frame image URL (jpg/jpeg/png/gif/bmp).

Minimum string length: 1

Example:

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

end_frame_image

string

End frame image URL (jpg/jpeg/png/gif/bmp).

Minimum string length: 1

Example:

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

mid_frame_images

object[]

Optional mid-frame keyframes. Each tag must be referenced in the prompt via @tag.

Show child attributes

duration

integer

default:5

Video duration in seconds.

Required range: 3 <= x <= 15

Example:

5

resolution

enum<string>

default:1080p

Output video resolution.

Available options:

480p,

720p,

1080p

Example:

"1080p"

mode

enum<string>

default:std

Quality/performance mode. fast is quicker (sound must be false); std balances speed and quality.

Available options:

fast,

std

Example:

"std"

sound

boolean

default:false

Whether to generate audio. Not supported when mode=fast.

Example:

false

prompt_optimizer

boolean

default:true

Enable automatic prompt expansion/optimization.

Example:

true

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

Skyreels t2v Skyreels r2v