API Reference

Lipsync

Requests

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get lip sync request

client.Lipsync.Requests.Get(ctx, id) (*LipsyncRequest, error)

GET/v1/lipsync/requests/{id}

Returns a single lip sync request by request UUID or reference_id.

ParametersExpand Collapse

id string

minLength1

ReturnsExpand Collapse

type LipsyncRequest struct{…}

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

Get lip sync request

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"),
  )
  lipsyncRequest, err := client.Lipsync.Requests.Get(context.TODO(), "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", lipsyncRequest.ID)
}

200 example

200 example

401 example

401 example

401 example

401 example

401 example

404 example

429 example

500 example

{
  "id": "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8",
  "reference_id": "dub-episode-42",
  "status": "completed",
  "created_at": "2026-04-07T10:00:00Z",
  "started_at": "2026-04-07T10:00:05Z",
  "finished_at": "2026-04-07T10:01:30Z",
  "output_url": "https://storage.chamelaion.com/output/6f82a2d8.mp4"
}

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "reference_id": "dub-episode-43",
  "status": "failed",
  "created_at": "2026-04-07T11:00:00Z",
  "started_at": "2026-04-07T11:00:04Z",
  "finished_at": "2026-04-07T11:00:12Z",
  "error_message": "video URL is not accessible"
}

{
  "error": "missing authorization header"
}

{
  "error": "invalid authorization format"
}

{
  "error": "missing token"
}

{
  "error": "invalid token"
}

{
  "error": "unauthorized"
}

{
  "error": "lipsync request not found"
}

{
  "error": "rate limit exceeded"
}

{
  "error": "internal error"
}

Returns Examples

200 example

200 example

401 example

401 example

401 example

401 example

401 example

404 example

429 example

500 example

{
  "id": "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8",
  "reference_id": "dub-episode-42",
  "status": "completed",
  "created_at": "2026-04-07T10:00:00Z",
  "started_at": "2026-04-07T10:00:05Z",
  "finished_at": "2026-04-07T10:01:30Z",
  "output_url": "https://storage.chamelaion.com/output/6f82a2d8.mp4"
}

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "reference_id": "dub-episode-43",
  "status": "failed",
  "created_at": "2026-04-07T11:00:00Z",
  "started_at": "2026-04-07T11:00:04Z",
  "finished_at": "2026-04-07T11:00:12Z",
  "error_message": "video URL is not accessible"
}

{
  "error": "missing authorization header"
}

{
  "error": "invalid authorization format"
}

{
  "error": "missing token"
}

{
  "error": "invalid token"
}

{
  "error": "unauthorized"
}

{
  "error": "lipsync request not found"
}

{
  "error": "rate limit exceeded"
}

{
  "error": "internal error"
}