---
title: "Query M2V task"
method: GET
path: "/query"
---

# Query M2V task

`GET /query`

Query M2V task status and result

## Query parameters

- `taskId` string, required
- `needCloudFrontUrl` boolean

## Response `200`

Query success

- object
  - `code` string, required — 200: success Other: fail
  - `message` string, required
  - `result` object
    - `taskId` string — Task ID used to uniquely identify the task
    - `status` 'init' | 'running' | 'fail' | 'success' — init | running | fail | success
    - `productName` string — Name of the product associated with the videos
    - `productDescription` string — Detailed description of the product's features and specifications
    - `exportVideos` object[]
      - `scriptId` number — Script ID associated with the exported video
      - `status` 'init' | 'running' | 'success' | 'fail' | 'null' — init | running | success | fail | null
      - `title` string — Title of the exported video
      - `description` string — Description of the exported video
      - `videoUrl` string — URL of the exported video file
      - `coverUrl` string — URL of the cover image for the video
      - `videoDuration` number — Duration of the video in milliseconds
      - `videoEtag` string — ETag for the video file, used for cache validation
    - `previewVideos` object[]
      - `scriptId` number — Script ID associated with the preview video
      - `status` 'init' | 'running' | 'success' | 'fail' | 'null' — init | running | success | fail | null
      - `title` string — Title of the exported video
      - `description` string — Description of the preview video
      - `videoUrl` string — URL of the preview video file
      - `coverUrl` string — URL of the cover image for the preview video
      - `videoDuration` number — Duration of the preview video in milliseconds
      - `videoEtag` string — ETag for the preview video file, used for cache validation
    - `videoSceneInfoList` object[] — Array of video scene information objects containing details about the scenes in the video
      - `mediaId` string — Media ID for the scene
      - `seq` number — Sequence number of the scene
      - `mediaType` string — Type of media (video or image)
      - `sceneAnalyseDesc` string — Description of the scene analysis
      - `sceneFileName` string — File name of the scene video
      - `videoSceneCoverUrl` string — URL of the cover image for the scene video
      - `start` number — Start time of the scene in seconds
      - `end` number — End time of the scene in seconds
    - `imageSceneInfoList` object[] — Array of image scene information objects containing details about the images
      - `mediaId` string — Media ID for the image scene
      - `mediaType` string — Type of media (image)
      - `sceneAnalyseDesc` string — Description of the scene analysis for the image
      - `sceneFileName` string — File name of the image scene
      - `imageSceneUrl` string — URL of the image scene
    - `scriptContentList` object[] — Array of script content objects containing details about the script segments
      - `scriptId` number — ID of the script
      - `scriptContents` object[] — Array of script content segments
        - `segId` number — Segment ID of the script content
        - `segText` string — Text of the script segment
    - `errorMsg` string

---

[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)