---
title: "Get lip sync task by task ID"
method: GET
path: "/v2/lip_sync_video/{task_id}"
tags: ["Video"]
---

# Get lip sync task by task ID

`GET /v2/lip_sync_video/{task_id}`

Query lip sync task status and result by task ID.

## Path parameters

- `task_id` string, required

## Response `200`

Success

- object
  - `code` integer, required — 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
  - `msg` string, required — Response message
  - `data` object
    - `task_id` string — Lip sync task ID
    - `status` 'pending' | 'processing' | 'success' | 'failed' — Task status
    - `created_at` integer — Task creation timestamp in seconds
    - `completed_at` integer — Task completion timestamp in seconds, present when finished
    - `data` object, nullable
      - `result_url` string, uri — Final output video URL
      - `cover_url` string, uri — Final output cover URL
      - `duration_seconds` number — Final output duration in seconds
    - `error` object, nullable
      - `message` string — Failure message when status is `failed`

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/versions/ec8807ce9c12/schema)
