​
Video Creation API

The video creation service allows you to transform your static images into dynamic animations using artificial intelligence.

​
Generate a video

​
POST /api/animation/v2/generate

​
Request Parameters

​
user_id
string
required

The unique user identifier (UUID) that you can retrieve from your Developer Space

​
image_urls
array
required

Array of URLs of images to animate. Currently, the first image in the array is used for video creation.

​
option
string
required

Desired animation type. Possible values: “ZOOM_IN”, “ZOOM_OUT”, “PAN_RIGHT”, “PAN_LEFT”, “PAN_UP”, “PAN_DOWN”, “CAMERA_PUSH_OUT”

​
prompt
string

Textual description to guide the visual style of the animation (optional)

​
format
string

Video orientation format. Possible values: “portrait” (768x1280 format) or any other value for landscape format (1280x768). By default, landscape format is used.

​
webhook
string

Webhook URL to receive a notification when the generation is complete

​
Response

​
generation_id
string

The unique generation identifier (UUID) to use with the retrieval API

​
remaining_videos
number

The number of video credits remaining for the user

​
project_id
string

The unique project identifier (UUID)

​
Request Example

curl --request POST \
--url 'https://iacrea.com/api/animation/v2/generate' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_urls": ["https://example.com/image.jpg"],
  "option": "ZOOM_OUT",
  "prompt": "Elegant modern living room",
  "format": "portrait"
}'

​
Response Example

{
  "generation_id": "uuid",
  "remaining_videos": 10,
  "project_id": "uuid"
}

​
Available Animation Types

OptionDescription
ZOOM_INZoom-in effect towards the inside of the image
ZOOM_OUTZoom-out effect moving away from the image
PAN_RIGHTCamera movement to the right
PAN_LEFTCamera movement to the left
PAN_UPCamera movement upward
PAN_DOWNCamera movement downward
CAMERA_PUSH_OUTFluid movement combining zoom and displacement

​
Retrieve a video

​
POST /api/animation/v2/get

​
Request Parameters

​
user_id
string
required

The unique user identifier (UUID) that you can retrieve from your Developer Space

​
generation_id
string
required

The unique generation identifier (UUID) returned by the generation API

​
Response

​
status
string

Generation status: “STARTING”, “IN_PROGRESS”, “SUCCEEDED”, “FAILED”

​
urls
array

Array containing the URLs of generated videos (present only if status=“SUCCEEDED”)

​
Request Example

curl --request POST \
--url 'https://iacrea.com/api/animation/v2/get' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'

​
Response Example

{
  "status": "SUCCEEDED",
  "urls": ["https://generated-video-url.mp4"]
}

​
Possible Generation States

StatusDescription
STARTINGGeneration is initializing
IN_PROGRESSVideo is being created
SUCCEEDEDGeneration completed successfully
FAILEDAn error occurred during generation

Important note: In case of “FAILED” status, your video credits are automatically refunded.