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.

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

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