Create image-to-video task

API Reference

Generate a video from an image and motion prompt. The output video preserves the input aspect ratio, with the longest edge limited to 1024 pixels.

Poll Get image-to-video task status until COMPLETED or FAILED.

Model:image-to-video

Credit:129/video (0-8 seconds), 4/second (each additional second)

post/v1/videos/image-to-video

Authorization — This endpoint requires an API key. Pass it in the api-key header on every request. Learn more

Thời gian xử lý trung bình

Cho video đầu ra dài 8 giây.

Thời gian xử lý: ≈ 44 giây

Yêu cầu đầu vào

Hình ảnh

Định dạng: JPEG, PNG, WEBP
Độ phân giải tối đa: 3000 × 3000 px

Xem tất cả yêu cầu đầu vào

Parameters

Name	Type	Status	Description
`task_id`	string	Required
`prompt`	string	Required	Motion prompt.
`duration`	number	Optional	Output duration in seconds.(default: `4`)

Responses

Task createdTaskCreatedResponse

Field	Type	Description
`task_id`	string	Unique task identifier. Poll the matching task-status endpoint for results.
`status`	string
`created_at`	integer	Unix timestamp of task creation

curl -X POST "https://api.snapedit.app/v1/videos/image-to-video" \
  -H "api-key: YOUR_API_KEY" \
  -F "task_id=value" \
  -F "prompt=value" \
  -F "duration=4"

Response

{
  "task_id": "task_abc123",
  "status": "CREATED",
  "created_at": 1745827200
}

Examples (1 example)

Prompt

“The man smiles and turns his head left and right”

Input

Output