DreamAvatar - Digital Human Video Generator

Generate talking avatar videos from images and audio using DreamAvatar 3.0 Fast API.

Quick Start

1. Get API Key

Before using this skill, you need a DreamAPI API key. Visit https://api.newportai.com/api-reference/get-started to sign up and get your API key.

2. Configure API Key

Users must set their DreamAPI key in OpenClaw config:

openclaw config patch --json '{"skills": {"entries": {"dream-avatar": {"env": {"DREAM_API_KEY": "your-api-key-here"}}}}}'

Or add to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "dream-avatar": {
        "env": {
          "DREAM_API_KEY": "your-api-key"
        }
      }
    }
  }
}

3. Generate Video

You can provide input in two ways:

Option A: Local Files (Recommended)

• image: Path to a local image file (jpg, jpeg, png, webp, gif)
• audio: Path to a local audio file (mp3, wav, mp4, max 3 minutes)
• prompt: Description of the expression/behavior
• resolution (optional): "480p" or "720p", default "480p"

The skill will automatically upload your local files and generate the video.

Option B: Public URLs

• image: URL to a publicly accessible image (jpg, jpeg, png, webp, gif)
• audio: URL to a publicly accessible audio (mp3, wav, mp4, max 3 minutes)
• prompt: Description of the expression/behavior
• resolution (optional): "480p" or "720p", default "480p"

API Details

1. Get Upload Policy

POST https://api.newportai.com/api/file/v1/get_policy

Headers:

Authorization: Bearer {DREAM_API_KEY}
Content-Type: application/json

Request Body:

{
  "scene": "Dream-CN"
}

Response:

{
  "code": 0,
  "message": "success",
  "data": {
    "accessId": "LTAI5tF1QzxoHGvEcziVACyc",
    "policy": "eyJ0...",
    "signature": "G2TzrhlybemHbfFakysY4j2EI2I=",
    "dir": "tmp/dream/2024-11-19/5369207820989002/",
    "host": "https://dreamapi-oss.oss-cn-hongkong.aliyuncs.com",
    "expire": "1732005888",
    "callback": "eyJ0..."
  }
}

2. Upload File to OSS

POST https://dreamapi-oss.oss-cn-hongkong.aliyuncs.com

Form Data:

Response:

{
  "code": 0,
  "message": "success",
  "data": {
    "verifyStatus": false,
    "reqId": "732c9caa-0a2e-4aa1-87d9-52430a8f0314"
  }
}

The uploaded file URL will be: {host}/{key}