Image to Video API Documentation

Overview

Convert a still image into an AI-animated video. Control motion intensity, duration, and aspect ratio to produce smooth, high-quality video clips from a single reference image.

Primary Endpoint

POST/api/v1/userImage2Video/start

Start image to video conversion

Request Parameters

Name	Type	Required	Description
name	string	No	Name of the image to video task
image_url	string	Yes	URL of the source image
prompt	string	No	Generation prompt
negative_prompt	string	No	Negative prompt to avoid unwanted features
lora	string	No	Lora ID. If provided, prompt/negative_prompt can be omitted (prompt will be overwritten by lora preset on backend).
model_type	enum: GENERAL \| FLF2V	No	Model type for generation
model_version	enum: a2e \| a2e-v2 \| a2e-v2-flash	No	Algorithm model version. When omitted, Ultra users default to a2e-v2 and other roles default to a2e. a2e-v2 costs more per second; a2e-v2-flash uses a2e pricing. V2 models are not covered by plan waivers and ignore auto_add_audio because they generate audio by themselves.
end_image_url	string	No	End image URL (required for FLF2V model)
extend_prompt	boolean	No	Whether to extend the prompt automatically
number_of_images	integer	No	Number of videos to generate at once
video_time	integer	No	Video time in seconds (5, 10, 15, or 20 seconds)
video_length	integer	No	(Deprecated) Video length in frames. Prefer video_time. Backend converts frames to seconds internally.
skip_face_enhance	boolean	No	Whether to skip face similarity enhancement. Defaults to false (enhancing face similarity).
mask_face	boolean	No	Web NSFW preflight result. Set true only after the user confirms masking a detected human face.
minor_suspected_skip	boolean	No	If suspected minor is detected (10 <= age < 15), set to true to acknowledge and proceed
webhook_url	string	No	HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth.
webhook_token	string	No	Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e.

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/userImage2Video/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My Image Animation",
  "image_url": "https://example.com/image.jpg",
  "prompt": "Make the person in the image wave their hand",
  "negative_prompt": "blurry, distorted, static",
  "lora": "string",
  "model_type": "GENERAL",
  "model_version": "a2e",
  "end_image_url": "https://example.com/end_image.jpg",
  "extend_prompt": true,
  "number_of_images": 1,
  "video_time": 5,
  "video_length": 81
}'

Related Endpoints

POST/api/v1/userImage2Video/start

Start image to video conversion

GET/api/v1/userImage2Video/allRecords

List image to video tasks

POST/api/v1/userImage2Video/batchDetail

Batch query task details

GET/api/v1/userImage2Video/avgProcessingTime

Get average processing time

GET/api/v1/userImage2Video/unlimitedQueueLevel

unlimitedQueueLevel

POST/api/v1/userImage2Video/{_id}/markShared

Mark record as shared

POST/api/v1/userImage2Video/{_id}/markDownloaded

Mark record as downloaded

POST/api/v1/userImage2Video/{_id}/markCopied

Mark record as copied

GET/api/v1/userImage2Video/{_id}

Get image to video task detail

DELETE/api/v1/userImage2Video/{_id}

Delete an image to video task

POST/api/v1/userImage2Video/prompt_extension

Extend prompt for image to video

POST/api/v1/userImage2Video/flf2v_prompt_extension

Extend prompt for FLF2V image to video

Responses

200

Image to video task started successfully

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid or missing bearer token