Submit Task

post

https://api.topview.ai/v2/common_task/image2video/task/submit

Submit an image-to-video generation task using the V2 API. Supports multiple input modes: single image, first/last frames, or multiple reference images. Supports multiple AI models with customizable resolution, aspect ratio, duration, and other parameters. For sample requests and model descriptions, please refer to the documentation API Usage

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

model

string

required

Defaults to seedance-1.5-pro

Model ID, e.g., 'seedance-1.5-pro', 'kling-v3', 'sora-2', etc. (Priority is higher than mode field)

firstFrameFileId

string

File ID of the first frame image (optional, depends on model input mode)

endFrameFileId

string

File ID of the end frame image (optional, depends on model input mode)

referenceImageFileIds

array of strings

List of reference image file IDs for multi-image mode. At least 2 images required. Should not include first/end frames (optional)

referenceImageFileIds

prompt

string

Positive prompt describing the desired video content (optional)

aspectRatio

string

Aspect ratio such as '16:9', '9:16', '1:1', etc. (optional, depends on model support)

resolution

integer

enum

Video resolution: 480 or 720 or 1080 (optional)

Allowed:

duration

integer

Video duration in seconds. Supported values depend on the model used (optional)

sound

string

enum

Defaults to off

Whether to include sound effects: 'on' or 'off' (optional, default: 'off')

Allowed:

generatingCount

integer

1 to 4

Defaults to 1

Number of videos to generate: 1-4 (optional, default: 1)

boardId

string

Board ID. When provided, creates a board task record in the system (optional)

noticeUrl

string

Callback URL for task completion notifications. Please refer to the API documentation for details (optional)

Headers

Topview-Uid

string

required

Defaults to <your-topview-uid>

User ID

Authorization

string

required

Defaults to Bearer <your-api-key>

API Key for authentication

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Task submitted successfully