## Generate lip sync from URLs

**post** `/v1/lipsync/generate`

Starts a lip sync job from exactly one remote video URL and one remote audio URL.
The response includes a request identifier to poll later.

### Body Parameters

- `inputs: array of object { type, url }`

  Exactly one video input and one audio input (order does not matter).

  - `type: "video" or "audio"`

    Type of input media.

    - `"video"`

    - `"audio"`

  - `url: string`

    URL of the media resource.

- `disable_active_speaker_detection: optional boolean`

  Disable active speaker detection and use max-face lipsync preprocessing.

- `reference_id: optional string`

  Optional client-provided identifier for later retrieval.

### Returns

- `LipsyncGenerate = object { request_id, status }`

  - `request_id: string`

    Identifier of the created lip sync request.

  - `status: "success"`

    Current state of the newly created request.

    - `"success"`

### Example

```http
curl https://api.chamelaion.com/api/v1/lipsync/generate \
    -H 'Content-Type: application/json' \
    -H "x-api-key: $CHAMELAION_API_KEY" \
    -d '{
          "inputs": [
            {
              "type": "video",
              "url": "https://cdn.example.com/episodes/42.mp4"
            },
            {
              "type": "audio",
              "url": "https://cdn.example.com/dubs/42-japanese.wav"
            }
          ]
        }'
```

#### Response

```json
{
  "status": "success",
  "request_id": "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8"
}
```