DreamAvatar - 数字人视频生成器

通过DreamAvatar 3.0快速API，从图片和音频生成说话头像视频。

快速开始

1. 获取API密钥

使用此技能前，您需要获取DreamAPI的API密钥。访问 https://api.newportai.com/api-reference/get-started 注册并获取您的API密钥。

更多AI工具，请访问：https://tools.dreamfaceapp.com/home

2. 配置API密钥

用户必须在OpenClaw配置中设置DreamAPI密钥：

bash
openclaw config patch --json {skills: {entries: {dream-avatar: {env: {DREAMAPIKEY: your-api-key-here}}}}}

或添加到 ~/.openclaw/openclaw.json：
json
{
skills: {
entries: {
dream-avatar: {
env: {
DREAMAPIKEY: your-api-key
}
}
}
}
}

3. 生成视频

您可以通过两种方式提供输入：

方式A：本地文件（推荐）

• - image：本地图片文件路径（jpg、jpeg、png、webp、gif格式）
• audio：本地音频文件路径（mp3、wav、mp4格式，最长3分钟）
• prompt：表情/行为的描述
• resolution（可选）：480p或720p，默认为480p

该技能将自动上传您的本地文件并生成视频。

方式B：公共URL

• - image：可公开访问的图片URL（jpg、jpeg、png、webp、gif格式）
• audio：可公开访问的音频URL（mp3、wav、mp4格式，最长3分钟）
• prompt：表情/行为的描述
• resolution（可选）：480p或720p，默认为480p

API详情

1. 获取上传策略

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

请求头：

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

请求体：
json
{
scene: Dream-CN
}

响应：
json
{
code: 0,
message: success,
data: {
accessId: LTAI5tF1QzxoHGvEcziVACyc,
policy: eyJ0...,
signature: G2TzrhlybemHbfFakysY4j2EI2I=,
dir: tmp/dream/2024-11-19/5369207820989002/,
host: https://...,
expire: 1732005888,
callback: eyJ0...
}
}

2. 上传文件到OSS

表单数据：

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

上传的文件URL将为：{host}/{key}

3. 生成视频（图片转视频）

POST https://api.newportai.com/api/async/dreamavatar/imagetovideo/3.0fast

请求头：

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

请求体：
json
{
image: https://.../photo.jpg,
audio: https://.../speech.mp3,
prompt: 一个微笑说话的人,
resolution: 480p
}

响应（任务提交）：
json
{
code: 0,
message: success,
data: {
taskId: aa4bf173ffd84c2f8734d536d6a7b5a7
}
}

4. 轮询获取结果

POST https://api.newportai.com/api/getAsyncResult

请求体：
json
{
taskId: your-task-id
}

完成时的响应：
json
{
code: 0,
message: success,
data: {
task: {
taskId: aa4bf173ffd84c2f8734d536d6a7b5a7,
status: 3,
taskType: dreamavatar/imagetovideo/3.0fast
},
videos: [
{
videoType: mp4,
videoUrl: https://...video.mp4
}
]
}
}

实现说明

• - 本地文件：技能自动处理上传。文件上传到OSS并生成URL。
• URL输入：图片和音频URL必须可公开访问（无需认证）
• 音频时长：不能超过3分钟
• API为异步：必须轮询获取结果
• 每2-3秒轮询一次，超时时间约60秒
• 状态码：0 = 待处理，1 = 处理中，2 = 处理中（非失败！），3 = 已完成，4 = 超时
• 上传的文件URL：仅有效1天（存储服务免费，但仅用于AI程序支持）

上传流程

本地文件 → 获取上传策略 → 上传到OSS → 获取公共URL → 生成视频

当提供本地文件时，技能自动实现此流程：

1. 1. 调用get_policy获取OSS凭证
2. 将图片/音频上传到OSS
3. 从host + key构建公共URL
4. 使用上传的URL调用DreamAvatar API
5. 轮询等待视频完成
6. 返回最终视频URL