revid-tweet-to-talking-head

name	revid-tweet-to-talking-head
description	Turn an X/Twitter/LinkedIn post (URL or pasted thread text) into a talking-head video that delivers the take. Use when a creator wants to repurpose a viral post as a short-form video.
metadata	{"openclaw":{"requires":{"config":"[Truncated]"}}}

Tweet / X / LinkedIn post → talking-head video

Take a single post or a thread and produce a 20–45 s talking-head video where an avatar reads the take.

When to use this skill

• Source is a tweet URL, X thread URL, LinkedIn post URL, or pasted thread text.
• Output is a talking-head delivering the post (avatar + voiceover + captions + minimal background motion).
• For an edited summary with stock visuals of an article, use revid-article-to-short instead.

Inputs

Field	Required	Notes
text or url	yes	Either the pasted thread (preferred — no scraping) or the post URL.
avatar.url or characterIds[]	yes	The face.
aspectRatio	no	Default 9:16
targetDuration	no	Default 30 (s)

Step-by-step

1. If you have the tweet/thread text, prefer script-to-video (no scraping risk — many social platforms block bots).
2. If you only have a URL, use article-to-video with a tight scrapingPrompt.
3. Either way, attach the avatar block + a single characterId.
4. POST /render.
5. Poll /status.

API call template — pasted thread (preferred)

POST /api/public/v3/render
Host: www.revid.ai
Content-Type: application/json
key: $REVID_API_KEY

{
  "workflow": "script-to-video",
  "source": {
    "text": "{TWEET_OR_THREAD_TEXT}"
  },
  "aspectRatio": "9:16",
  "avatar": {
    "enabled": true,
    "url": "{AVATAR_IMAGE_URL}",
    "removeBackground": true
  },
  "voice":    { "enabled": true, "voiceId": "aria-en-us", "stability": 0.65, "speed": 1.05 },
  "captions": {       
         
   
     
     
     
     
  
   
     
     
     
     
  
        

summarizationPreference: "no-summarization" — for tweets, the original phrasing IS the value. Don't paraphrase.

API call template — URL (fallback)

{
  "workflow": "article-to-video",
  "source": {
    "url": "{POST_URL}",
    "scrapingPrompt": "Extract only the original post text and the thread author. Ignore replies, reposts, and side panels."
  },
  "aspectRatio": "9:16",
  "avatar": { "enabled": true, "url": "{AVATAR_IMAGE_URL}", "removeBackground": true },
  "voice":   { "enabled": true, "voiceId": "aria-en-us", "stability": 0.65 },
  "captions"     
        
            
        
       

Examples

• examples/thread-text.json
• examples/run.sh

Failure modes

Symptom	Fix
scrape failed on URL form	Switch to the pasted-thread template — copy the post body into source.text.
Lip-sync drifts on multi-tweet thread	Lower targetDuration to 25 s, or set summarizationPreference: "summarize".
Avatar reads in the wrong tone	Set voice.voiceId explicitly to a voice that matches the persona; default voice is rarely right for personality-driven content.
Tweet contains URLs / @mentions / hashtags	The voice will read them aloud awkwardly. Pre-clean the text: strip raw URLs, replace @handle with the person's name, and remove standalone hashtags (or keep one as a sign-off).

See also

• revid-blog-to-avatar-video — same pattern, longer source.
• revid-script-to-video.
• revid-api-foundations.