Start Image-to-Video

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

name

string

required

The name associated with the request.

image_url

string

required

The image url for the video generation. Use /api/v1/tos/transferToStorage if your image url is unstable to access.

prompt

string

required

the prompt for your i2v task. e.g. the person is speaking. Looking at the camera. detailed eyes, clear teeth,static camera view point, still background

negative_prmpt

string

required

the negative prompt. e.g. six fingers, bad hands, lowres, low quality, worst quality, moving camera view point, still image

Example

{
  "name": "Test name",
  "image_url": "https://example.com/524f2258-c5a0-4bb2-9003-5e4740a2d376.png",
  "prompt": "the person is speaking. Looking at the camera. detailed eyes, clear teeth, static view point, still background",
  "negative_prompt": "six fingers, bad hands, lowres, low quality, worst quality, moving view point, static image"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://video.a2e.ai/api/v1/userImage2Video/start' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Test name",
    "image_url": "https://example.com/524f2258-c5a0-4bb2-9003-5e4740a2d376.png",
    "prompt": "the person is speaking. Looking at the camera. detailed eyes, clear teeth, static view point, still background",
    "negative_prompt": "six fingers, bad hands, lowres, low quality, worst quality, moving view point, static image"
}'

Responses

🟢200OK

application/json

Body

code

integer

required

0 is OK

data

object

required

_id

string

required

name

string

required

image_url

string

required

current_status

string

required

coins

integer

required

createdAt

string

required

failed_message

string

required

failed_code

string

required

trace_id

string

required

Example

{
  "code": 0,
  "data": {
    "_id": "67d29023dd27a536fdf6e809",
    "name": "Test name",
    "image_url": "https://example.com/524f2258-c5a0-4bb2-9003-5e4740a2d376.png",
    "prompt": "the person is speaking. Looking at the camera. detailed eyes, clear teeth,static camera view point, still background",
    "negative_prompt": "six fingers, bad hands, lowres, low quality, worst quality, moving camera view point, still image",
    "current_status": "sent",
    "coins": 100,
    "createdAt": "2025-03-13T07:58:27.863Z",
    "failed_message": "",
    "failed_code": ""
  },
  "trace_id": "a1ae4185-7929-4fe1-8903-13a41cc072fd"
}