> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取 Sora 任务结果

> get task result by taskId. Returns VideoTaskResultDto for video generation tasks, or RoleTaskResultDto for role creation tasks.



## OpenAPI

````yaml GET /sora/task/result
openapi: 3.0.0
info:
  title: Sora AI
  description: API documentation for Sora AI
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.mountsea.ai
    description: API Gateway
security: []
tags:
  - name: sora
    description: ''
paths:
  /sora/task/result:
    get:
      tags:
        - sora
      summary: get task result by taskId
      description: >-
        get task result by taskId. Returns VideoTaskResultDto for video
        generation tasks, or RoleTaskResultDto for role creation tasks.
      operationId: ApiPublicController_taskResult
      parameters:
        - name: taskId
          required: true
          in: query
          description: Task ID
          schema:
            example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
            type: string
      responses:
        '200':
          description: >-
            Task result. Can be either VideoTaskResultDto (for video generation)
            or RoleTaskResultDto (for role creation)
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/VideoTaskResultDto'
                  - $ref: '#/components/schemas/RoleTaskResultDto'
      security:
        - bearerAuth: []
components:
  schemas:
    VideoTaskResultDto:
      type: object
      properties:
        taskId:
          type: string
          description: task id
        status:
          enum:
            - ready
            - running
            - success
            - failed
            - timeout
          type: string
          description: task status
        errorMessage:
          type: string
          description: error message
        errorCode:
          type: number
          description: error code
        finishedAt:
          format: date-time
          type: string
          description: task finished time
        createdAt:
          format: date-time
          type: string
          description: task created time
        traceId:
          type: string
          description: traceId
        result:
          description: task result
          nullable: true
          allOf:
            - $ref: '#/components/schemas/VideoResultDto'
        progress:
          type: number
          description: progress, 0-100
      required:
        - taskId
        - status
    RoleTaskResultDto:
      type: object
      properties:
        taskId:
          type: string
          description: task id
        status:
          enum:
            - ready
            - running
            - success
            - failed
            - timeout
          type: string
          description: task status
        errorMessage:
          type: string
          description: error message
        errorCode:
          type: number
          description: error code
        finishedAt:
          format: date-time
          type: string
          description: task finished time
        createdAt:
          format: date-time
          type: string
          description: task created time
        traceId:
          type: string
          description: traceId
        result:
          description: task result
          nullable: true
          allOf:
            - $ref: '#/components/schemas/RoleResultDto'
      required:
        - taskId
        - status
    VideoResultDto:
      type: object
      properties:
        video_url:
          type: string
          description: video url, currently only returns one video url
        editId:
          type: string
          description: >-
            edit id, you can use this id to edit video, if not returned, you
            cannot edit the video
      required:
        - video_url
    RoleResultDto:
      type: object
      properties:
        cameoId:
          type: string
          description: >-
            cameo id, you can use this id to edit role, if not returned, you
            cannot edit the role
        characterId:
          type: string
          description: character id
          example: ch_691d67468fcc8191a7c1cec1f2d181fe
        username:
          type: string
          description: username of the role
          example: mikeniuniu
        displayName:
          type: string
          description: display name of the role
          example: Celestia Volt
        coverImageUrl:
          type: string
          description: cover image url of the role
          example: https://example.com/example.jpg
        instruction_set:
          description: instruction set of the role
          example:
            - type: text
              value: instruction text
          type: array
          items:
            type: string
        safety_instruction_set:
          description: safety instruction set of the role
          example:
            - type: text
              value: safety instruction text
          type: array
          items:
            type: string
      required:
        - cameoId
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````