Submit Task

post

https://api.topview.ai/v1/common_task/text2video/task/submit

Convert text prompts to video content. Supports multiple AI models with customizable resolution, aspect ratio, duration, and other parameters. Returns a taskId for asynchronous result polling.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

model

string

required

Defaults to Seedance 1.5 pro

Model name, e.g., 'Seedance 1.5 pro', 'Kling V3', 'Sora 2', 'Topview Pro', etc.

prompt

string

required

Defaults to A professional product showcase video of an elegant watch rotating against a minimalist white background with perfect lighting

Positive prompt describing the video content to generate (required)

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

Please refer to the API documentation for details NoticeUrl

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