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

# Get Lip Sync Video Task

> Query lip sync task status and result by task ID.


Query the status and result of a lip sync video task by `task_id`.

## Example Usage

```bash theme={null}
curl --request GET \
  --url 'https://api.jogg.ai/v2/lip_sync_video/3d5c6930-d0da-4f7b-826e-cd1530f6734f' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Related Guides

<CardGroup cols={2}>
  <Card title="Create Lip Sync Video Task" href="/api-reference/v2/Video/CreateLipSyncVideo">
    Submit a new lip sync task
  </Card>
</CardGroup>


## OpenAPI

````yaml GET /v2/lip_sync_video/{task_id}
openapi: 3.0.1
info:
  title: JoggAI OpenAPI v2
  description: >
    JoggAI OpenAPI v2 provides a comprehensive suite of endpoints for creating
    and managing AI-powered video content.


    ## Authentication

    All API requests require authentication using an API key provided in the
    `x-api-key` header.


    ## Base URL

    Production: https://api.jogg.ai/v2


    ## Rate Limiting

    API calls are subject to rate limiting based on your subscription plan.


    ## Error Handling

    All endpoints return standard HTTP status codes along with detailed error
    messages in the response body.
  version: 2.0.0
  license:
    name: MIT
servers:
  - url: https://api.jogg.ai
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: Video
    description: Video creation and management operations
  - name: Avatar
    description: Avatar management and creation operations
  - name: Voice
    description: Voice and timbre management operations
  - name: Asset
    description: Asset management including music, scripts, and uploads
  - name: Template
    description: Template management operations
  - name: Product
    description: Product management operations
  - name: User
    description: User account operations
  - name: Webhook
    description: Webhook endpoint management for event notifications
paths:
  /v2/lip_sync_video/{task_id}:
    get:
      tags:
        - Video
      summary: Get lip sync task by task ID
      description: |
        Query lip sync task status and result by task ID.
      parameters:
        - name: task_id
          in: path
          required: true
          description: Lip sync task ID
          schema:
            type: string
            example: 3d5c6930-d0da-4f7b-826e-cd1530f6734f
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          task_id:
                            type: string
                            description: Lip sync task ID
                            example: 3d5c6930-d0da-4f7b-826e-cd1530f6734f
                          status:
                            type: string
                            description: Task status
                            enum:
                              - pending
                              - processing
                              - success
                              - failed
                            example: success
                          created_at:
                            type: integer
                            description: Task creation timestamp in seconds
                            example: 1741500000
                          completed_at:
                            type: integer
                            description: >-
                              Task completion timestamp in seconds, present when
                              finished
                            example: 1741500030
                          data:
                            type: object
                            nullable: true
                            properties:
                              result_url:
                                type: string
                                format: uri
                                description: Final output video URL
                                example: https://res.jogg.ai/lipsync-result.mp4
                              cover_url:
                                type: string
                                format: uri
                                description: Final output cover URL
                                example: https://res.jogg.ai/lipsync-cover.jpg
                              duration_seconds:
                                type: number
                                description: Final output duration in seconds
                                example: 12.5
                          error:
                            type: object
                            nullable: true
                            properties:
                              message:
                                type: string
                                description: Failure message when status is `failed`
                                example: >-
                                  consume retry limit reached: audio duration
                                  fetch failed
components:
  schemas:
    BaseResponse:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          description: |
            Business status code:
            * 0 - Success
            * 10104 - Record not found
            * 10105 - Invalid API key
            * 18020 - Insufficient credit
            * 18025 - No permission to call APIs
            * 40000 - Parameter error
            * 50000 - System error
          example: 0
        msg:
          type: string
          description: Response message
          example: Success
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Obtain your key from the JoggAI dashboard.

````