P-Video-Avatar

P-Video-Avatar is a portrait-driven avatar video model that turns a single image into a speaking video using either an uploaded audio track or a generated voice from script. It is built for production avatar workflows with strong lip sync, selectable voices and languages, optional speaking-style control, seeded generation, and 720p or 1080p output for scalable talking-head video creation.
API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Art Deco Radio Announcer
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'prunaai:p-video@avatar',
positivePrompt: 'A refined broadcast presenter delivering a cultured on-camera introduction, subtle natural head movement, realistic blinking, precise lip sync, elegant posture, polished broadcast presence, warm cinematic lighting, detailed facial realism, stable camera, premium avatar video quality',
resolution: '1080p',
seed: 94680,
speech: {
text: 'Good evening, listeners. You are hearing a special transmission from the Meridian Hour, where craft, curiosity, and clear voices still matter. Tonight, we welcome you with a steady hand, a bright signal, and a promise to make every word count.',
voice: 'Pulcherrima (Female)',
language: 'en-US'
},
settings: {
promptUpsampling: true,
safetyFilter: true,
voicePrompt: 'Speak with smooth classic broadcast poise, warm confidence, crisp diction, measured pacing, and a gracious welcoming tone.'
},
inputs: {
frameImages: [
'https://assets.runware.ai/assets/inputs/bf2bbe8e-68a2-4ec9-b372-7487d62dd048.jpg'
]
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "prunaai:p-video@avatar",
"positivePrompt": "A refined broadcast presenter delivering a cultured on-camera introduction, subtle natural head movement, realistic blinking, precise lip sync, elegant posture, polished broadcast presence, warm cinematic lighting, detailed facial realism, stable camera, premium avatar video quality",
"resolution": "1080p",
"seed": 94680,
"speech": {
"text": "Good evening, listeners. You are hearing a special transmission from the Meridian Hour, where craft, curiosity, and clear voices still matter. Tonight, we welcome you with a steady hand, a bright signal, and a promise to make every word count.",
"voice": "Pulcherrima (Female)",
"language": "en-US"
},
"settings": {
"promptUpsampling": True,
"safetyFilter": True,
"voicePrompt": "Speak with smooth classic broadcast poise, warm confidence, crisp diction, measured pacing, and a gracious welcoming tone."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/bf2bbe8e-68a2-4ec9-b372-7487d62dd048.jpg"
]
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "5d231f3c-8d47-411d-8311-ee1e7acb43af",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A refined broadcast presenter delivering a cultured on-camera introduction, subtle natural head movement, realistic blinking, precise lip sync, elegant posture, polished broadcast presence, warm cinematic lighting, detailed facial realism, stable camera, premium avatar video quality",
"resolution": "1080p",
"seed": 94680,
"speech": {
"text": "Good evening, listeners. You are hearing a special transmission from the Meridian Hour, where craft, curiosity, and clear voices still matter. Tonight, we welcome you with a steady hand, a bright signal, and a promise to make every word count.",
"voice": "Pulcherrima (Female)",
"language": "en-US"
},
"settings": {
"promptUpsampling": true,
"safetyFilter": true,
"voicePrompt": "Speak with smooth classic broadcast poise, warm confidence, crisp diction, measured pacing, and a gracious welcoming tone."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/bf2bbe8e-68a2-4ec9-b372-7487d62dd048.jpg"
]
}
}
]'runware run prunaai:p-video@avatar \
positivePrompt="A refined broadcast presenter delivering a cultured on-camera introduction, subtle natural head movement, realistic blinking, precise lip sync, elegant posture, polished broadcast presence, warm cinematic lighting, detailed facial realism, stable camera, premium avatar video quality" \
resolution=1080p \
seed=94680 \
speech.text="Good evening, listeners. You are hearing a special transmission from the Meridian Hour, where craft, curiosity, and clear voices still matter. Tonight, we welcome you with a steady hand, a bright signal, and a promise to make every word count." \
speech.voice="Pulcherrima (Female)" \
speech.language=en-US \
settings.promptUpsampling=true \
settings.safetyFilter=true \
settings.voicePrompt="Speak with smooth classic broadcast poise, warm confidence, crisp diction, measured pacing, and a gracious welcoming tone." \
inputs.frameImages.0=https://assets.runware.ai/assets/inputs/bf2bbe8e-68a2-4ec9-b372-7487d62dd048.jpg{
"taskType": "videoInference",
"taskUUID": "5d231f3c-8d47-411d-8311-ee1e7acb43af",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A refined broadcast presenter delivering a cultured on-camera introduction, subtle natural head movement, realistic blinking, precise lip sync, elegant posture, polished broadcast presence, warm cinematic lighting, detailed facial realism, stable camera, premium avatar video quality",
"resolution": "1080p",
"seed": 94680,
"speech": {
"text": "Good evening, listeners. You are hearing a special transmission from the Meridian Hour, where craft, curiosity, and clear voices still matter. Tonight, we welcome you with a steady hand, a bright signal, and a promise to make every word count.",
"voice": "Pulcherrima (Female)",
"language": "en-US"
},
"settings": {
"promptUpsampling": true,
"safetyFilter": true,
"voicePrompt": "Speak with smooth classic broadcast poise, warm confidence, crisp diction, measured pacing, and a gracious welcoming tone."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/bf2bbe8e-68a2-4ec9-b372-7487d62dd048.jpg"
]
}
}{
"taskType": "videoInference",
"taskUUID": "5d231f3c-8d47-411d-8311-ee1e7acb43af",
"videoUUID": "2f04e1d8-f6bb-4305-b2de-ef79a9b4154c",
"videoURL": "https://vm.runware.ai/video/os/a03d21/ws/5/vi/2f04e1d8-f6bb-4305-b2de-ef79a9b4154c.mp4",
"seed": 94680,
"cost": 0.8658
}Retro-Futurist Transit Host Introduction
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'prunaai:p-video@avatar',
positivePrompt: 'A polished speaking avatar video of a retro-futurist space terminal host addressing viewers directly, steady camera, realistic facial motion, accurate mouth articulation, subtle head movement, natural blinking, confident on-camera presence, cinematic yet clean broadcast look',
resolution: '720p',
seed: 23606,
speech: {
text: 'Welcome aboard the Meridian Transfer Gate. Departures for the Helios Ring, the Ceres Gardens, and Low Orbit Civic Station are now boarding by color group. Please keep your travel documents ready, follow the amber guidance lights, and enjoy a calm onward journey among the stars.',
voice: 'Leda (Female)',
language: 'en-US'
},
settings: {
promptUpsampling: true,
safetyFilter: true,
voicePrompt: 'Warm professional announcer, clear diction, measured pacing, reassuring tone, slight sense of wonder, like a premium interplanetary terminal host.'
},
inputs: {
frameImages: [
'https://assets.runware.ai/assets/inputs/9fe93dc4-52a1-47b9-808d-1ac25a4c0180.jpg'
]
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "prunaai:p-video@avatar",
"positivePrompt": "A polished speaking avatar video of a retro-futurist space terminal host addressing viewers directly, steady camera, realistic facial motion, accurate mouth articulation, subtle head movement, natural blinking, confident on-camera presence, cinematic yet clean broadcast look",
"resolution": "720p",
"seed": 23606,
"speech": {
"text": "Welcome aboard the Meridian Transfer Gate. Departures for the Helios Ring, the Ceres Gardens, and Low Orbit Civic Station are now boarding by color group. Please keep your travel documents ready, follow the amber guidance lights, and enjoy a calm onward journey among the stars.",
"voice": "Leda (Female)",
"language": "en-US"
},
"settings": {
"promptUpsampling": True,
"safetyFilter": True,
"voicePrompt": "Warm professional announcer, clear diction, measured pacing, reassuring tone, slight sense of wonder, like a premium interplanetary terminal host."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/9fe93dc4-52a1-47b9-808d-1ac25a4c0180.jpg"
]
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "71406df4-fdd4-4fe1-8cb8-5702123c02cf",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A polished speaking avatar video of a retro-futurist space terminal host addressing viewers directly, steady camera, realistic facial motion, accurate mouth articulation, subtle head movement, natural blinking, confident on-camera presence, cinematic yet clean broadcast look",
"resolution": "720p",
"seed": 23606,
"speech": {
"text": "Welcome aboard the Meridian Transfer Gate. Departures for the Helios Ring, the Ceres Gardens, and Low Orbit Civic Station are now boarding by color group. Please keep your travel documents ready, follow the amber guidance lights, and enjoy a calm onward journey among the stars.",
"voice": "Leda (Female)",
"language": "en-US"
},
"settings": {
"promptUpsampling": true,
"safetyFilter": true,
"voicePrompt": "Warm professional announcer, clear diction, measured pacing, reassuring tone, slight sense of wonder, like a premium interplanetary terminal host."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/9fe93dc4-52a1-47b9-808d-1ac25a4c0180.jpg"
]
}
}
]'runware run prunaai:p-video@avatar \
positivePrompt="A polished speaking avatar video of a retro-futurist space terminal host addressing viewers directly, steady camera, realistic facial motion, accurate mouth articulation, subtle head movement, natural blinking, confident on-camera presence, cinematic yet clean broadcast look" \
resolution=720p \
seed=23606 \
speech.text="Welcome aboard the Meridian Transfer Gate. Departures for the Helios Ring, the Ceres Gardens, and Low Orbit Civic Station are now boarding by color group. Please keep your travel documents ready, follow the amber guidance lights, and enjoy a calm onward journey among the stars." \
speech.voice="Leda (Female)" \
speech.language=en-US \
settings.promptUpsampling=true \
settings.safetyFilter=true \
settings.voicePrompt="Warm professional announcer, clear diction, measured pacing, reassuring tone, slight sense of wonder, like a premium interplanetary terminal host." \
inputs.frameImages.0=https://assets.runware.ai/assets/inputs/9fe93dc4-52a1-47b9-808d-1ac25a4c0180.jpg{
"taskType": "videoInference",
"taskUUID": "71406df4-fdd4-4fe1-8cb8-5702123c02cf",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A polished speaking avatar video of a retro-futurist space terminal host addressing viewers directly, steady camera, realistic facial motion, accurate mouth articulation, subtle head movement, natural blinking, confident on-camera presence, cinematic yet clean broadcast look",
"resolution": "720p",
"seed": 23606,
"speech": {
"text": "Welcome aboard the Meridian Transfer Gate. Departures for the Helios Ring, the Ceres Gardens, and Low Orbit Civic Station are now boarding by color group. Please keep your travel documents ready, follow the amber guidance lights, and enjoy a calm onward journey among the stars.",
"voice": "Leda (Female)",
"language": "en-US"
},
"settings": {
"promptUpsampling": true,
"safetyFilter": true,
"voicePrompt": "Warm professional announcer, clear diction, measured pacing, reassuring tone, slight sense of wonder, like a premium interplanetary terminal host."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/9fe93dc4-52a1-47b9-808d-1ac25a4c0180.jpg"
]
}
}{
"taskType": "videoInference",
"taskUUID": "71406df4-fdd4-4fe1-8cb8-5702123c02cf",
"videoUUID": "81bc5f63-eddd-4361-8502-c2881d6b9550",
"videoURL": "https://vm.runware.ai/video/os/a04d20/ws/5/vi/81bc5f63-eddd-4361-8502-c2881d6b9550.mp4",
"seed": 23606,
"cost": 0.536
}Harbor Weather Beacon Presenter
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'prunaai:p-video@avatar',
positivePrompt: 'A realistic speaking avatar video of a harbor weather beacon presenter delivering a maritime update. Subtle natural head motion, accurate lip sync, attentive expression, professional broadcast composure, gentle blinking, tiny shoulder shifts, believable facial animation, nautical charts and instrument details softly visible behind the subject, cool daylight palette, polished modern briefing aesthetic.',
resolution: '1080p',
seed: 33224,
settings: {
promptUpsampling: true,
safetyFilter: true
},
inputs: {
frameImages: [
'https://assets.runware.ai/assets/inputs/dd6efac9-4fa8-4345-9738-9ba4c31a6e5f.jpg'
],
audio: 'https://assets.runware.ai/assets/inputs/aab9475f-a1c8-4ec4-b3ad-270a4e0180ba.mp3'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "prunaai:p-video@avatar",
"positivePrompt": "A realistic speaking avatar video of a harbor weather beacon presenter delivering a maritime update. Subtle natural head motion, accurate lip sync, attentive expression, professional broadcast composure, gentle blinking, tiny shoulder shifts, believable facial animation, nautical charts and instrument details softly visible behind the subject, cool daylight palette, polished modern briefing aesthetic.",
"resolution": "1080p",
"seed": 33224,
"settings": {
"promptUpsampling": True,
"safetyFilter": True
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/dd6efac9-4fa8-4345-9738-9ba4c31a6e5f.jpg"
],
"audio": "https://assets.runware.ai/assets/inputs/aab9475f-a1c8-4ec4-b3ad-270a4e0180ba.mp3"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "816dadb6-c4c9-4594-96d8-96ecf85f5c23",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A realistic speaking avatar video of a harbor weather beacon presenter delivering a maritime update. Subtle natural head motion, accurate lip sync, attentive expression, professional broadcast composure, gentle blinking, tiny shoulder shifts, believable facial animation, nautical charts and instrument details softly visible behind the subject, cool daylight palette, polished modern briefing aesthetic.",
"resolution": "1080p",
"seed": 33224,
"settings": {
"promptUpsampling": true,
"safetyFilter": true
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/dd6efac9-4fa8-4345-9738-9ba4c31a6e5f.jpg"
],
"audio": "https://assets.runware.ai/assets/inputs/aab9475f-a1c8-4ec4-b3ad-270a4e0180ba.mp3"
}
}
]'runware run prunaai:p-video@avatar \
positivePrompt="A realistic speaking avatar video of a harbor weather beacon presenter delivering a maritime update. Subtle natural head motion, accurate lip sync, attentive expression, professional broadcast composure, gentle blinking, tiny shoulder shifts, believable facial animation, nautical charts and instrument details softly visible behind the subject, cool daylight palette, polished modern briefing aesthetic." \
resolution=1080p \
seed=33224 \
settings.promptUpsampling=true \
settings.safetyFilter=true \
inputs.frameImages.0=https://assets.runware.ai/assets/inputs/dd6efac9-4fa8-4345-9738-9ba4c31a6e5f.jpg \
inputs.audio=https://assets.runware.ai/assets/inputs/aab9475f-a1c8-4ec4-b3ad-270a4e0180ba.mp3{
"taskType": "videoInference",
"taskUUID": "816dadb6-c4c9-4594-96d8-96ecf85f5c23",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A realistic speaking avatar video of a harbor weather beacon presenter delivering a maritime update. Subtle natural head motion, accurate lip sync, attentive expression, professional broadcast composure, gentle blinking, tiny shoulder shifts, believable facial animation, nautical charts and instrument details softly visible behind the subject, cool daylight palette, polished modern briefing aesthetic.",
"resolution": "1080p",
"seed": 33224,
"settings": {
"promptUpsampling": true,
"safetyFilter": true
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/dd6efac9-4fa8-4345-9738-9ba4c31a6e5f.jpg"
],
"audio": "https://assets.runware.ai/assets/inputs/aab9475f-a1c8-4ec4-b3ad-270a4e0180ba.mp3"
}
}{
"taskType": "videoInference",
"taskUUID": "816dadb6-c4c9-4594-96d8-96ecf85f5c23",
"videoUUID": "577ae793-fcb1-4fe9-863d-96766a7dc5a1",
"videoURL": "https://vm.runware.ai/video/os/a04d20/ws/5/vi/577ae793-fcb1-4fe9-863d-96766a7dc5a1.mp4",
"seed": 33224,
"cost": 0.583
}Cliffside Lighthouse Keeper Address
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'prunaai:p-video@avatar',
positivePrompt: 'A realistic talking-head avatar video of a seasoned lighthouse keeper delivering a heartfelt message to camera, subtle head motion, natural blinking, precise lip sync, gentle wind-touched atmosphere, maritime character details, soft overcast daylight, cinematic realism, stable framing, broadcast-quality facial animation',
resolution: '720p',
seed: 8458,
settings: {
promptUpsampling: true,
safetyFilter: true,
voicePrompt: 'Steady, warm, reassuring, reflective pacing with quiet authority.'
},
inputs: {
frameImages: [
'https://assets.runware.ai/assets/inputs/f83003e0-a57e-4eb8-aad2-84ff290861bb.jpg'
],
audio: 'https://assets.runware.ai/assets/inputs/fb05ab84-add4-469e-b55f-02e673baa667.mp3'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "prunaai:p-video@avatar",
"positivePrompt": "A realistic talking-head avatar video of a seasoned lighthouse keeper delivering a heartfelt message to camera, subtle head motion, natural blinking, precise lip sync, gentle wind-touched atmosphere, maritime character details, soft overcast daylight, cinematic realism, stable framing, broadcast-quality facial animation",
"resolution": "720p",
"seed": 8458,
"settings": {
"promptUpsampling": True,
"safetyFilter": True,
"voicePrompt": "Steady, warm, reassuring, reflective pacing with quiet authority."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/f83003e0-a57e-4eb8-aad2-84ff290861bb.jpg"
],
"audio": "https://assets.runware.ai/assets/inputs/fb05ab84-add4-469e-b55f-02e673baa667.mp3"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "f201814d-8291-47f1-8217-3fe2ed1b9c01",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A realistic talking-head avatar video of a seasoned lighthouse keeper delivering a heartfelt message to camera, subtle head motion, natural blinking, precise lip sync, gentle wind-touched atmosphere, maritime character details, soft overcast daylight, cinematic realism, stable framing, broadcast-quality facial animation",
"resolution": "720p",
"seed": 8458,
"settings": {
"promptUpsampling": true,
"safetyFilter": true,
"voicePrompt": "Steady, warm, reassuring, reflective pacing with quiet authority."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/f83003e0-a57e-4eb8-aad2-84ff290861bb.jpg"
],
"audio": "https://assets.runware.ai/assets/inputs/fb05ab84-add4-469e-b55f-02e673baa667.mp3"
}
}
]'runware run prunaai:p-video@avatar \
positivePrompt="A realistic talking-head avatar video of a seasoned lighthouse keeper delivering a heartfelt message to camera, subtle head motion, natural blinking, precise lip sync, gentle wind-touched atmosphere, maritime character details, soft overcast daylight, cinematic realism, stable framing, broadcast-quality facial animation" \
resolution=720p \
seed=8458 \
settings.promptUpsampling=true \
settings.safetyFilter=true \
settings.voicePrompt="Steady, warm, reassuring, reflective pacing with quiet authority." \
inputs.frameImages.0=https://assets.runware.ai/assets/inputs/f83003e0-a57e-4eb8-aad2-84ff290861bb.jpg \
inputs.audio=https://assets.runware.ai/assets/inputs/fb05ab84-add4-469e-b55f-02e673baa667.mp3{
"taskType": "videoInference",
"taskUUID": "f201814d-8291-47f1-8217-3fe2ed1b9c01",
"model": "prunaai:p-video@avatar",
"positivePrompt": "A realistic talking-head avatar video of a seasoned lighthouse keeper delivering a heartfelt message to camera, subtle head motion, natural blinking, precise lip sync, gentle wind-touched atmosphere, maritime character details, soft overcast daylight, cinematic realism, stable framing, broadcast-quality facial animation",
"resolution": "720p",
"seed": 8458,
"settings": {
"promptUpsampling": true,
"safetyFilter": true,
"voicePrompt": "Steady, warm, reassuring, reflective pacing with quiet authority."
},
"inputs": {
"frameImages": [
"https://assets.runware.ai/assets/inputs/f83003e0-a57e-4eb8-aad2-84ff290861bb.jpg"
],
"audio": "https://assets.runware.ai/assets/inputs/fb05ab84-add4-469e-b55f-02e673baa667.mp3"
}
}{
"taskType": "videoInference",
"taskUUID": "f201814d-8291-47f1-8217-3fe2ed1b9c01",
"videoUUID": "b8bbd928-5cf8-4690-bc75-7b238b5911fb",
"videoURL": "https://vm.runware.ai/video/os/a09dlim3/ws/5/vi/b8bbd928-5cf8-4690-bc75-7b238b5911fb.mp4",
"seed": 8458,
"cost": 0.3657
}