API Reference

Lipsync

Requests

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List lip sync requests

client.Lipsync.Requests.List(ctx, query) (*LipsyncRequestListResponse, error)

GET/v1/lipsync/requests

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

ParametersExpand Collapse

query LipsyncRequestListParams

Limit param.Field[int64]optional

Maximum number of items to return.

minimum1

Offset param.Field[int64]optional

Number of items to skip before returning results.

minimum0

ReferenceID param.Field[string]optional

Filter requests by exact reference_id.

ReturnsExpand Collapse

type LipsyncRequestListResponse struct{…}

Data []LipsyncRequest

ID string

Lip sync request ID.

formatuuid

CreatedAt Time

Request creation time in UTC.

formatdate-time

Status string

Current request status.

ErrorMessage stringoptional

Failure message when status is failed.

FinishedAt Timeoptional

Request processing completion time in UTC.

formatdate-time

OutputURL stringoptional

URL to the generated output media, when available.

formaturi

ReferenceID stringoptional

Client-provided identifier for this request.

StartedAt Timeoptional

Request processing start time in UTC.

formatdate-time

Pagination LipsyncRequestListResponsePagination

Limit int64

Applied page size.

minimum1

Offset int64

Applied result offset.

minimum0

Total int64

Total number of matching records.

minimum0

List lip sync requests

Go

HTTP

TypeScript

Python

Go

package main

import (
  "context"
  "fmt"

  "github.com/chamelaion/chamelaion-go"
  "github.com/chamelaion/chamelaion-go/option"
)

func main() {
  client := chamelaion.NewClient(
    option.WithAPIKey("My API Key"),
  )
  requests, err := client.Lipsync.Requests.List(context.TODO(), chamelaion.LipsyncRequestListParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", requests.Data)
}

200 example

200 example

401 example

401 example

401 example

401 example

401 example

429 example

500 example

{
  "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

200 example

200 example

401 example

401 example

401 example

401 example

401 example

429 example

500 example

{
  "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"
}