Pixverse Avatar API

About Pixverse Avatar

Turns a single portrait into a talking avatar video, driven by an uploaded audio track or by text spoken with a built-in voice.

Pixverse Avatar specs

Model ID

pixverse-avatar

Provider

PixVerse

Category

Video Generation

Released

-

Input

TextImageAudio

Output

Video

Endpoints

POST/v1/videos/generations

Alternate model IDs

pixverse/avatar

Pixverse Avatar API pricing

Live pay-as-you-go rates from the EmpirioLabs catalog. You are billed only for what you use, with no monthly minimum.

How to call the Pixverse Avatar API

Pixverse Avatar runs through POST /v1/videos/generations. The request returns a job_id right away; poll GET /v1/jobs/{job_id} until the job completes and read the output URLs from the result. Get an API key from the EmpirioLabs dashboard.

curl https://api.empiriolabs.ai/v1/videos/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-avatar",
    "prompt": "Describe what you want Pixverse Avatar to generate."
  }'

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/videos/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "pixverse-avatar",
        "prompt": "Describe what you want Pixverse Avatar to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)

Pixverse Avatar API parameters

Request parameters supported by the Pixverse Avatar API on EmpirioLabs. Defaults apply when a field is omitted.

Good to know

Turns a single portrait image into a talking avatar video, driven either by an audio file you supply or by text spoken with a built-in voice.

Inputs

• image: the portrait to animate. Use a clear, front-facing subject.
• audio: the speech to perform, or lip_sync_tts_content with lip_sync_tts_speaker_id to have the model speak your text. Fourteen named voices are available plus Auto.
• prompt is optional and can describe delivery or framing.

Output

• 360p, 540p, 720p and 1080p.

Billing

• Billed per second of speech at the rate for the output resolution. Text-to-speech input is metered in 15-character blocks at the same rate, so the charge tracks the length of the script.

Input limits

• Image: PNG, JPEG or WebP, up to 20MB and 10000px on the long edge.
• Audio: MP3, WAV, M4A or AAC.

Pixverse Avatar API: common questions

How much does the Pixverse Avatar API cost?

On EmpirioLabs, Pixverse Avatar is billed pay as you go: 360p $0.10 per second; 540p $0.20 per second; 720p $0.30 per second. The live rate card on this page always matches what the API charges.

Which endpoint does Pixverse Avatar use?

Pixverse Avatar is served through POST /v1/videos/generations on api.empiriolabs.ai with standard bearer-token authentication.

Can I try Pixverse Avatar in the browser before integrating?

Yes. The EmpirioLabs playground runs Pixverse Avatar in the browser with the same parameters the API exposes, so you can test prompts before writing code.

How do I get a Pixverse Avatar API key?

Create an EmpirioLabs account, then generate a key under API Keys in the dashboard. Billing is pay-as-you-go credits, so you only pay for the requests you make.