---
title: "Submit Image to Video Generation Task (V2)"
method: POST
path: "/v2/common_task/image2video/task/submit"
---

# Submit Image to Video Generation Task (V2)

`POST /v2/common_task/image2video/task/submit`

Submit an image-to-video generation task using the V2 API (MQ callback mode). 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.

## Headers

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

## Request body

- object
  - `model` string, required — 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` string[] — List of reference image file IDs for multi-image mode. At least 2 images required. Should not include first/end frames (optional)
  - `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` 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 — Callback URL for task completion notifications. Please refer to the [API documentation](https://docs.topview.ai/reference/post_notice-notice-url-check#/) for details (optional)

## Response `200`

Task submitted successfully

- object
  - `code` string — Response status code
  - `message` string — Response message
  - `result` object — Task submission result
    - `taskId` string — Task ID for subsequent result queries
    - `status` 'init' | 'running' | 'success' | 'fail' — Task status, initial value is 'init'
    - `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)