# 查询任务状态

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api-v1/get-status:
    get:
      summary: 查询任务状态
      deprecated: false
      description: 主动查询任务状态（视频翻译、声音克隆、语音合成），时效性 5 秒，建议优先使用回调（notify参数）接收任务结果通知。
      tags:
        - API 列表
      parameters:
        - name: id
          in: query
          description: 任务 ID
          required: true
          example: h6TaEFSWJEwi
          schema:
            type: string
        - name: taskName
          in: query
          description: 任务名称，表明任务是视频翻译、声音克隆，还是语音合成。
          required: true
          example: tts
          schema:
            type: string
            enum:
              - dubbing
              - cloneVoice
              - tts
            x-apifox-enum:
              - name: ''
                value: dubbing
                description: 视频翻译
              - name: ''
                value: cloneVoice
                description: 声音克隆
              - name: ''
                value: tts
                description: 语音合成
        - name: Authorization
          in: header
          description: 您的 api key
          required: true
          example: '******'
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: 状态码
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        description: 任务状态
                        enum:
                          - done
                          - failed
                        x-apifox-enum:
                          - name: ''
                            value: done
                            description: 任务成功
                          - name: ''
                            value: failed
                            description: 任务失败
                      result:
                        type: string
                        description: 任务结果链接（缓存一周，建议自行转储；如果是声音克隆任务，result 为空）
                    required:
                      - status
                      - result
                    x-apifox-orders:
                      - status
                      - result
                    description: 任务结果
                  msg:
                    type: string
                    description: 返回信息
                required:
                  - code
                  - data
                  - msg
                x-apifox-orders:
                  - code
                  - data
                  - msg
              examples:
                '1':
                  summary: 成功示例
                  value:
                    code: 0
                    data:
                      status: done
                      result: >-
                        https://m3.yunmaovideo.com/api-v1/H7TaEFSWJEwi/MVrvU3mVz1.wav
                    msg: ''
                '2':
                  summary: 异常示例（未知任务）
                  value:
                    code: 6003
                    msg: 未知任务！
                    data: null
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: API 列表
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4444157/apis/api-171444336-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://mapi.yunmaovideo.com
    description: 正式环境
security: []

```