---
title: "Submit Text to Video Generation Task"
method: POST
path: "/v1/common_task/text2video/task/submit"
---

# Submit Text to Video Generation Task

`POST /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.

## Headers

- `Topview-Uid` string, required
- `Authorization` string, required

## Request body

- object
  - `model` string, required — Model name, e.g., 'Seedance 1.5 pro', 'Kling V3', 'Sora 2', 'Topview Pro', etc.
  - `prompt` string, required — 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` 480 | 720 | 1080 — Video resolution: 480 or 720 or 1080 (optional)
  - `duration` integer — Video duration in seconds. Supported values depend on the model used (optional)
  - `sound` 'on' | 'off' — Whether to include sound effects: 'on' or 'off' (optional, default: 'off')
  - `generatingCount` integer — 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](https://docs.topview.ai/reference/post_notice-notice-url-check#/) for details NoticeUrl

## Response `200`

Task submitted successfully

- object
  - `code` string
  - `message` string
  - `result` object
    - `taskId` string — Task ID for subsequent result queries
    - `status` 'init' | 'running' | 'success' | 'fail' — Task status
    - `boardTaskIds` string[] — List of board task IDs (returned if task is associated with a board)
    - `boardId` string — Board ID (returned if task is associated with a board)
    - `noticeUuid` string — Notification UUID for async callback tracking

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/revisions/83cd46ca7859/schema)