create a new generation job

getting started

authenticate and make your first request to the generate api.

authorize

enter your api key in the x-api-key field within the Authorization section.

enter your x-api-key in the authorization section

enter params

enter the params in the body section:

fill out the body with the required parameters.

example input:

{
  "model": "sync-1.7.1-beta",
  "input": [
    {
      "type": "audio",
      "url": "https://example.com/audio.mp3"
    },
    {
      "type": "video",
      "url": "https://example.com/video.mp4"
    }
  ],
}

send a request

click the Send button to submit your request. after the submission, you will receive a response that includes the id of your job, the current status, and the details to track your job.

{
  "id": "unique_job_id",
  "createdAt": "date_time",
  "status": "PROCESSING",
  "model": "sync-1.7.1-beta",
  "input": [
    {
      "type": "audio",
      "url": "https://example.com/audio.mp3"
    },
    {
      "type": "video",
      "url": "https://example.com/video.mp4"
    }
  ],
  "webhookUrl": null,
  "options": {},
  "stream": false,
  "outputUrl": null
}

your job’s status will start as pending and move to processing. use the returned id with the GET /lipsync/{id} endpoint to periodically poll for the status of your job. this polling is crucial for knowing when your video is ready.

what to do next

explore options for monitoring your job’s progress and receiving updates.

Authorizations

x-api-key

string

header

required

Body

application/json

input

object[]

required

input media to use for generation. this is an array of media items.

model

enum<string>

default:

loop

required

name of the model to use for generation.

Available options:

lipsync-1.8.0,

lipsync-1.8.0-beta,

lipsync-1.7.1,

lipsync-1.6.0,

lipsync-1.9.0-beta

options

object

additional options available for generation.

webhookUrl

string

webhook url for generation status updates. once the generation completes we will send a POST request to the webhook url with the generation data.

Response

201 - application/json

createdAt

string

required

The date and time the generation was created.

string

required

A unique identifier for the generation.

input

object[]

required

An array of input objects containing type and URL.

model

string

required

The name of the model used for generation.

status

enum<string>

required

The status of the generation.

Available options:

PENDING,

PROCESSING,

COMPLETED,

FAILED,

REJECTED,

CANCELED

error

string

The error message if the generation failed.

options

object

Options for the generation.

outputDuration

object

The duration of the output media.

outputUrl

object

The URL of the output media.

webhookUrl

object

The URL to the webhook endpoint.

getting started

api reference

​getting started

​what to do next

Authorizations

Body

Response

getting started

what to do next