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

# Get Video Compose Status

> Query the status and output URLs of a video composition task submitted by the current license.



## OpenAPI

````yaml GET /api/open/v1/video-compose/status
openapi: 3.1.0
info:
  title: NavTalk API
  description: NavTalk API for AI avatar management, file uploads, and video generation
  version: 1.0.0
servers:
  - url: https://api.navtalk.ai
    description: NavTalk Production Environment Server
  - url: https://qaapi.navtalk.ai
    description: NavTalk QA Environment Server
  - url: https://devapi.navtalk.ai
    description: NavTalk Development Environment Server
security:
  - navtalkLicenseAuth: []
paths:
  /api/open/v1/video-compose/status:
    get:
      tags:
        - Video Compose
      summary: Get Video Compose Status
      description: >-
        Query the status and output URLs of a video composition task submitted
        by the current license.
      operationId: getVideoComposeStatus
      parameters:
        - name: taskId
          in: query
          description: Task ID returned by `POST /api/open/v1/video-compose/submit`.
          required: true
          schema:
            type: string
            example: 6d7e24b7-412d-46ec-8d95-940099a3e979
      responses:
        '200':
          description: Task status retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoComposeStatusResponse'
              example:
                code: 200
                message: SUCCESS
                data:
                  taskId: 6d7e24b7-412d-46ec-8d95-940099a3e979
                  status: Published
                  title: My first synthesis task
                  videoUrl: https://api.navtalk.ai/uploadFiles/navtalk.Brain.mp4
                  thumbnailUrl: https://api.navtalk.ai/uploadFiles/navtalk.Brain.png
                  audioUrl: https://api.navtalk.ai/uploadFiles/2026-05-18/voice.mp3
                  resultUrl: >-
                    https://api.navtalk.ai/uploadFiles/2026-05-18/final-result.mp4
                  failMessage: null
                  prompt: Hello, welcome to NavTalk.
                  voice: cedar
                  voiceName: cedar
                  avatarId: 4024d39983b4d4b488bba9377268fbac
        '400':
          description: Task not found, license validation failed, or query error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NavtalkErrorResponse'
              example:
                code: 400
                message: Task not found
      security:
        - navtalkLicenseAuth: []
components:
  schemas:
    VideoComposeStatusResponse:
      type: object
      properties:
        code:
          type: integer
          example: 200
        message:
          type: string
          example: SUCCESS
        data:
          $ref: '#/components/schemas/VideoComposeTask'
    NavtalkErrorResponse:
      type: object
      properties:
        code:
          type: integer
          example: 400
        message:
          type: string
          example: Invalid license key
    VideoComposeTask:
      type: object
      properties:
        taskId:
          type: string
          description: Task ID.
          example: 6d7e24b7-412d-46ec-8d95-940099a3e979
        status:
          type: string
          enum:
            - Draft
            - Processing
            - Published
            - Fail
          description: Current task status.
          example: Published
        title:
          type: string
          description: Task title.
          example: My first synthesis task
        videoUrl:
          type: string
          description: >-
            Full public URL for the source visual asset associated with the
            task.
          example: https://api.navtalk.ai/uploadFiles/navtalk.Brain.mp4
        thumbnailUrl:
          type: string
          description: Full public thumbnail URL when available.
          example: https://api.navtalk.ai/uploadFiles/navtalk.Brain.png
        audioUrl:
          type: string
          description: Full public URL for the source audio used in the task.
          example: https://api.navtalk.ai/uploadFiles/2026-05-18/voice.mp3
        resultUrl:
          type: string
          description: >-
            Full public URL for the final generated video. Present when
            generation succeeds.
          example: https://api.navtalk.ai/uploadFiles/2026-05-18/final-result.mp4
        failMessage:
          type: string
          description: Failure message when `status` is `Fail`.
          example: Failed to generate audio from text
        prompt:
          type: string
          description: The original `textContent` submitted for TTS tasks.
          example: Hello, welcome to NavTalk.
        voice:
          type: string
          description: Voice key bound to the avatar when TTS is used.
          example: cedar
        voiceName:
          type: string
          description: Voice display name currently returned by the service.
          example: cedar
        avatarId:
          type: string
          description: Avatar ID used for this task, if applicable.
          example: 4024d39983b4d4b488bba9377268fbac
  securitySchemes:
    navtalkLicenseAuth:
      type: apiKey
      in: header
      name: license
      description: NavTalk API license key (e.g. sk_navtalk_...)

````