Skip to main content
POST
/
api
/
portrait
/
effects
/
hitchcock-effects
Hitchcock special effects
curl --request POST \
  --url https://www.ailabapi.com/api/portrait/effects/hitchcock-effects \
  --header 'Content-Type: multipart/form-data' \
  --header 'ailabapi-api-key: <api-key>' \
  --form version=v2 \
  --form image_target='@example-file' \
  --form mode=0 \
  --form long_side=960 \
  --form frame_num=90 \
  --form fps=30 \
  --form use_flow=-1 \
  --form 'speed_shift=<string>'
{
  "request_id": "",
  "log_id": "",
  "error_code": 0,
  "error_code_str": "",
  "error_msg": "",
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "data": {
    "video": ""
  }
}

Authorizations

​
ailabapi-api-key
string
header
required

API Key for authentication

Body

multipart/form-data
​
version
string

Version.

Example:

"v2"

​
image_target
file
​
mode
integer

Camera movement mode.

  • 0: Push forward shot, default with flowing effect.
  • 1: Wide-angle camera movement.
  • 2: Hitchcock camera movement.
  • 3: Swing camera movement.
  • 4: Bounce camera movement.

    • Example:

    "0"

    ​
    long_side
    integer

    The length of the video's longer side for rendering. The larger the value, the longer it takes, growing exponentially in powers of two.

    Example:

    "960"

    ​
    frame_num
    integer

    Video frame rate (without speed change). The larger the value, the longer it takes, increasing linearly.

    Example:

    "90"

    ​
    fps
    integer

    Video frame rate. frame_num/fps determines the video duration.

    Example:

    "30"

    ​
    use_flow
    number

    Whether to apply the flow effect. Enabling the flow effect typically increases processing time by approximately 20% to 30%.

  • -1: The algorithm determines whether to enable the flow effect based on the mode value.
  • 0: Forcefully disable the flow effect.
  • 1: Forcefully enable the flow effect.

    • Example:

    "-1"

    ​
    speed_shift
    string

    Video Curve Speed Variation.

  • Each pair of adjacent values represents the x and y values of a control point.
  • x range [0, 1]: Progress from the beginning to the end of the original video.
  • y range [0.1, 10]: Speed rate.
  • Each pair of adjacent control points represents a speed change curve, with the curve function being a trigonometric function.

    • Response

    200 - application/json

    Success

    The response is of type object.