Skip to content

List lip sync requests

GET/v1/lipsync/requests

Returns a paginated list of lip sync requests for the authenticated account.

Query ParametersExpand Collapse

limit: optional number

Maximum number of items to return.

minimum1

offset: optional number

Number of items to skip before returning results.

minimum0

reference_id: optional string

Filter requests by exact reference_id.

ReturnsExpand Collapse

data: array of LipsyncRequest { id, created_at, status, 5 more }

id: string

Lip sync request ID.

formatuuid

created_at: string

Request creation time in UTC.

formatdate-time

status: string

Current request status.

error_message: optional string

Failure message when status is failed.

finished_at: optional string

Request processing completion time in UTC.

formatdate-time

output_url: optional string

URL to the generated output media, when available.

formaturi

reference_id: optional string

Client-provided identifier for this request.

started_at: optional string

Request processing start time in UTC.

formatdate-time

pagination: object { limit, offset, total }

limit: number

Applied page size.

minimum1

offset: number

Applied result offset.

minimum0

total: number

Total number of matching records.

minimum0

List lip sync requests

curl https://api.chamelaion.com/api/v1/lipsync/requests \
    -H "x-api-key: $CHAMELAION_API_KEY"

{
  "data": [
    {
      "id": "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8",
      "reference_id": "batch-2026-04",
      "status": "completed",
      "created_at": "2026-03-30T11:00:00Z",
      "started_at": "2026-03-30T11:00:04Z",
      "finished_at": "2026-03-30T11:01:09Z",
      "output_url": "https://storage.chamelaion.com/output/6f82a2d8.mp4"
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "reference_id": "batch-2026-04",
      "status": "queued",
      "created_at": "2026-03-30T11:02:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 2
  }
}

{
  "data": [
    {
      "id": "0d8e7a7b-1a4a-4af1-b1da-050f7d9d95bc",
      "reference_id": "order-12345-japanese-dub",
      "status": "processing",
      "created_at": "2026-03-31T09:40:00Z",
      "started_at": "2026-03-31T09:40:08Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

{
  "error": "missing authorization header"
}

{
  "error": "invalid authorization format"
}

{
  "error": "missing token"
}

{
  "error": "invalid token"
}

{
  "error": "unauthorized"
}

{
  "error": "rate limit exceeded"
}

{
  "error": "internal error"
}

Returns Examples

{
  "data": [
    {
      "id": "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8",
      "reference_id": "batch-2026-04",
      "status": "completed",
      "created_at": "2026-03-30T11:00:00Z",
      "started_at": "2026-03-30T11:00:04Z",
      "finished_at": "2026-03-30T11:01:09Z",
      "output_url": "https://storage.chamelaion.com/output/6f82a2d8.mp4"
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "reference_id": "batch-2026-04",
      "status": "queued",
      "created_at": "2026-03-30T11:02:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 2
  }
}

{
  "data": [
    {
      "id": "0d8e7a7b-1a4a-4af1-b1da-050f7d9d95bc",
      "reference_id": "order-12345-japanese-dub",
      "status": "processing",
      "created_at": "2026-03-31T09:40:00Z",
      "started_at": "2026-03-31T09:40:08Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

{
  "error": "missing authorization header"
}

{
  "error": "invalid authorization format"
}

{
  "error": "missing token"
}

{
  "error": "invalid token"
}

{
  "error": "unauthorized"
}

{
  "error": "rate limit exceeded"
}

{
  "error": "internal error"
}