VEED Lipsync is VEED's talking-head & lipsync video model on Versely. This page is its structured prompting reference: the 2 parameters its schema actually exposes, the talking-video technique that applies to it, copy-ready templates.
Everything here is grounded in the same sources Versely's agent reads — the model's input schema. Where a line is general craft advice rather than a documented fact about VEED Lipsync, the page says so.
What VEED Lipsync wants
The exact input surface, from the same schema the Versely agent fetches with get_model_input_schema before every generation.
| Parameter | What it does | Values |
|---|---|---|
video_urlreq | Source talking-head video (URL maxLength 2083) | string (max 2083) |
audio_urlreq | Replacement audio (URL maxLength 2083) | string (max 2083) |
Technique that applies here
Lipsync/avatar/audio-driven: text or audio input, delivery and framing controls
- Three different input shapes share this family, and figuring out which one your model uses tells you what 'the prompt' even means: text-is-the-script (HeyGen Avatar V3, VEED Avatars — your text becomes the spoken words), audio-drives-it (Kling Avatar Pro, LTX 2.3 Audio to Video, Wan 2.2 Speech to Video — the words come from your uploaded audio_url; any prompt text only shapes the visual scene/motion around it), or pure re-timing with no prompt field at all (Sync Lipsync 2.0, VEED Lipsync, VEED Fabric 1.0, Sync React 1).
- Kling Avatar Pro's input.prompt is required (max 5000 chars), but the schema describes it as a 'Motion/scene description,' not dialogue — writing your script into it does nothing, since input.audio_url is what the avatar actually lip-syncs to. Wan 2.2 Speech to Video has the same audio-drives-it shape but makes its equivalent prompt field optional.
- VEED Avatars' schema is narrower than sibling avatar products: only avatar_id and text are valid fields, per the schema's own constraint note — voice_id, language, and aspect_ratio are explicitly documented as not supported, even though HeyGen Avatar V3 does expose a separate voice ID and resolution control.
Copy-ready templates
Replace the bracketed slots; each template says when it's the right shape.
text: "[SCRIPT — what the avatar says]" · avatar_id: [PRESET AVATAR ID]
Use when: Scripting VEED Avatars — remember only avatar_id and text exist here; there's no separate voice, language, or aspect_ratio field to set.
Source [video/image]: [description of the face and framing] · Driving audio: [description and length] · [sync_mode or resolution setting]: [VALUE]
Use when: Briefing a Sync Lipsync 2.0, VEED Lipsync, or VEED Fabric 1.0 job — none of them have a creative prompt field, so your only real levers are which source and audio you pair, plus the length-mismatch or resolution setting.
How the Versely agent does this automatically
You can use this page by hand, or let the agent apply the same knowledge. Four real mechanisms — no more, no less:
get_model_input_schema— before generating, the agent looks up VEED Lipsync's exact input fields, required fields, allowed values, defaults, and min/max bounds. The parameter table above is that same surface.- The prompt enhancer's family rules — 12 per-family rewrite rules (this model's family isn't one of the 12, so only general enhancement applies) shape how a rough prompt gets rewritten.
- The per-provider speech guide — for TTS scripts, the agent follows a provider-specific tag scheme — not relevant to this model, but it's why voiceover scripts come out marked up correctly.
expand_movie_scene— in movie flows, brief scene ideas are rewritten into detailed cinematic descriptions before generation.
Mistakes that waste generations
- Typing your script into Kling Avatar Pro's or Wan 2.2 Speech to Video's prompt field and expecting the avatar to say it — both prompts are scene/motion descriptions; the spoken words come only from audio_url.
- Assuming VEED Avatars supports a separate voice or language selector the way HeyGen Avatar V3 does — its schema is explicitly limited to avatar_id and text; voice_id, language, and aspect_ratio are documented as not valid fields.
- Leaving VEED Fabric 1.0's resolution unset — unlike most other models in this family, it has no default; the schema marks it required (480p or 720p only), so an empty value fails instead of falling back to a default.
Frequently asked questions
Does VEED Lipsync support negative prompts?+
No — VEED Lipsync's published schema has no negative_prompt parameter. Exclusions have to be phrased positively inside the main prompt, or dropped.
How does the Versely agent know VEED Lipsync's parameters?+
Before generating, the agent calls its get_model_input_schema tool, which looks up the exact input fields, required fields, allowed values, defaults, and min/max bounds for the model. Nothing on this page is guessed — it is the same schema surface those tools read.
Related prompting guides
Generate with VEED Lipsync
VEED Lipsync is live in Versely — paste a template above, or just describe what you want and let the agent map it onto the schema for you.