Skip to main content
POST
Looping Video

Authorizations

X-API-KEY
string
header
required

All API requests require a valid api key. Include your token as a HTTP request header in the following format: X-API-Key: skXXXXXXXXXXXXXXXX. You can obtain an api key by signing up for developer access in your Pixelcut account.

Body

image_url
string<url>

URL of the image to be processed.

Example:

"https://cdn3.pixelcut.app/product.jpg"

image
file

Base64 encoded representation of the image to be processed.

prompt
string

Optional creative direction for the motion (e.g. what should move subtly). Directions requesting camera movement, cuts, new objects, or scene changes are ignored.

Maximum string length: 1000
Example:

"clothes blowing subtly in the wind, person slightly moving"

duration
integer<int32>
default:5

Length of the looping video in whole seconds (5-15).

Required range: 5 <= x <= 15
Example:

5

resolution
enum<string>
default:768p

Output resolution of the looping video. 480p costs 8 credits per second; 768p costs 16 credits per second.

Available options:
480p,
768p
Example:

"768p"

include_audio
boolean
default:true

Whether the generated MP4 keeps its audio track. When false, the audio track is stripped and the result is guaranteed to contain no audio stream. Audio does not change the price.

Example:

true

motion
enum<string>
default:subtle

Motion style. subtle adds gentle, natural movement that returns to the starting pose. spin shows the subject from every side through one full 360-degree revolution that ends on the starting view. People and isolated products on a plain background turn in place while the camera stays fixed; an object photographed in a real setting stays still and the camera orbits around it instead. Does not change the price.

Available options:
subtle,
spin
Example:

"subtle"

Response

Accepted - processing has started

job_id
string

A unique identifier for this job that can be used to check status.

Example:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"

status
enum<string>

Initial job status.

Available options:
pending
Example:

"pending"