Skip to main content
POST
Lip sync with P-Video Avatar

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
audio
string
required

The speech/audio to lip-sync (mp3/wav, up to 30 seconds, max 5 MB). A public audio URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads.

image
string
required

The avatar image (a person facing the camera works best). A public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. jpg/png/webp.

resolution
enum<string>
default:720p

Output resolution — sets the per-second price (720p = 40, 1080p = 60 credits/second).

Available options:
720p,
1080p
video_prompt
string

Optional visual prompt describing how the person should appear or behave while speaking.

Response

Job accepted.

credits
integer

Total price of this job (seconds x the model's per-second rate).

id
string

Opaque job id (mtn_...) — use it to poll status.

message
string
model
string
seconds
integer

Billed duration — the reference video's length

status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout