在线调试
填写业务相关参数免费在线调试
该分类下无相关接口
当前生成一个的时间很长,比较占用排队资源,仅限尝鲜使用
返回格式:application/json
请求方式:HTTPPOST
请求示例:
Creating with Act-One on Gen-3 Alpha
在 Gen-3 Alpha 上使用 Act-One 进行创作
Introduction 简介
Gen-3 Alpha is the first of upcoming models that offer improvements in fidelity, consistency, motion, and speed over previous generations of models.
Gen-3 Alpha 是即将推出的一系列模型中的第一个,这些模型在准确度、一致性、运动和速度方面相对于上一代模型有所改进。
Act-One allows you to bring a character image to life by uploading a driving performance to precisely influence expressions, mouth movements, and more.
Act-One 允许您通过上传驾驶表演来使角色图像栩栩如生,精确地影响表情、口型动作等。
In this article, driving performance refers to the video that will influence an image. Character image refers to the image that will be animated by the driving performance.
在这篇文章中,驾驶性能指的是会影响图像的视频。角色图像指的是会被驾驶性能动画化的图像。
This article outlines how to use Act-One on Gen-3 Alpha, input best practices, the available settings, and more.
这篇文章概述了如何在 Gen-3 Alpha 上使用 Act-One,输入最佳实践,可用设置以及更多内容。
Spec Information 规格信息
Spec 规格 Gen-3 Alpha 三代阿尔法
Cost 成本 10 credits per second, 50 credit minimum
每秒 10 积分,最低 50 积分
Maximum output duration 最大输出持续时间 30 seconds 30 秒
Explore Mode on Unlimited Plans
无限制计划的探索模式 Yes 是
Platform availability 平台可用性 Web 网络
Required base prompt inputs
所需的基本提示输入 Video 视频
Image 图片
Output resolutions 输出分辨率 1280x768
Frame Rate (FPS) 帧率(FPS) 24fps 24 帧/秒
Best Practices for Act-One Input
一、最佳实践:输入第一幕
Before diving in, review these best practices to ensure that your input selections will set your generation up for success. Most output issues can be addressed by using inputs that follow these recommendations.
在深入研究之前,请回顾这些最佳实践,以确保您的输入选择将为您的生成工作奠定成功的基础。大多数输出问题都可以通过使用遵循这些建议的输入来解决。
Driving Performance 驾驶性能
Well-lit with defined facial features
光线充足,面部特征明显
Single face framed from around the shoulders and up
单个脸框从肩膀周围向上
Forward-facing in the direction of the camera
面向摄像头的方向
Face is in frame for the entire video
整个视频中面部都在画面内
Ensure the face doesn't move in and out of the frame
确保面部不要在画面内进进出出
Clear mouth movement and expressions
清晰的口部动作和表情
Certain expressions, such as sticking out a tongue, are not supported
某些表达,例如伸出舌头,不被支持
Minimal body movement 最小的身体活动
No face occlusions in frame
画面中无面部遮挡
No cuts that interrupt the shot
不允许打断镜头的剪辑
Follows our Trust & Safety standards
遵循我们的信任与安全标准
Character Images 字符图像
Well-lit with defined facial features
光线充足,面部特征明显
A single face framed from around the shoulders and up
一张从肩膀以上框出的脸
Forward-facing in the direction of the camera
面向摄像头的方向
Follows our Trust & Safety standards
遵循我们的信任与安全标准
Step 1 – Uploading the Driving Performance
第一步 - 上载驾驶性能
Begin by navigating to Generative Video in your Dashboard.
从您的仪表板开始,导航至生成视频。
From here, make sure the Gen-3 Alpha model is selected from the top left corner dropdown. You’ll find the Act-One icon in the left hand toolbar:
从这里,请确保从左上角下拉菜单中选择 Gen-3 Alpha 模型。您会在左侧工具栏中找到 Act-One 图标:
In the top half of the Act-One window, drag and drop a new video or select an existing video from your Assets to add your driving performance.
在一幕一的上半部分窗口,拖放新的视频或从您的资产中选择现有的视频以添加您的驾驶表现。
Make sure that the driving performance follows our recommended best practices for the best results.
确保驾驶性能遵循我们推荐的最佳实践,以获得最佳结果。
Your driving performance should always be forward-facing, even if the character image you plan to upload is in a different angle.
您的驾驶表现始终应面向前方,即使您计划上传的角色图像角度不同。
Preliminary face-detection will run on your driving performance before you’re allowed to generate.
在您被允许生成之前,初步的面部检测将会对您的驾驶表现进行运行。
Below are examples of driving performances and their outputs:
以下是驾驶表现及其输出的示例: 以下是驾驶表现及其输出的示例: 1. 表现:平稳驾驶 输出:车辆行驶平稳,油耗低 2. 表现:高速行驶 输出:车辆加速迅速,稳定性高 3. 表现:城市驾驶 输出:车辆操控灵活,停车方便 4. 表现:越野驾驶 输出:车辆通过性强,适应各种路况 5. 表现:节能驾驶 输出:车辆燃油经济性好,环保 6. 表现:运动驾驶 输出:车辆动力强劲,驾驶乐趣高
Driving performance 驾驶性能 Output 输出
Once your driving performance is uploaded, you’re ready to choose your character image.
一旦您的驾驶表现上传完毕,就可以选择您的角色形象了。
Step 2 – Selecting the Character Image
步骤 2 – 选择字符图像
Select the character reference image in the bottom half of the Act-One window.
在一幕一窗口的下半部分选择角色引用图像。
Choose from an existing preset image, or switch to the Custom tab to upload your own.
从现有的预设图片中选择,或切换到自定义选项卡上传您自己的图片。
Act-One can support a wide variety of input images, but images that closely follow our best practices will provide more consistent results when compared to more experimental images.
Act-One 可以支持各种各样的输入图像,但遵循我们最佳实践的图像与更具实验性的图像相比,提供的结果会更加一致。
Below is a chart that outlines our recommendations in more detail. Variations annotated with a ✅ should work well in most cases, ⚠️ may sometimes work or provide unexpected results, and ❌ will likely not provide ideal results in most cases.
This chart isn’t meant to deter experimentation, but rather act as a resource for those who need each generation to be satisfactory. Don’t be afraid to travel outside of these recommendations if you’re looking to push the limits of Act-One.
Category 类别 Variation 变化 Example 示例 Support 支持
Character type 字符类型 Human 人类 ✅
Non-human ❌
Character angle Forward-facing/Front view ✅
Profile view ❌
Character distance Shoulders and up ✅
Torso and up ✅
Full body ⚠️
Character silhouette Intermediate ✅
Complex ⚠️
Step 3 – Generating the Act-One Video
步骤 3 - 生成第一幕视频
You can hover over the duration modal to see the calculated credit cost before generating.
Click the Generate button after confirming that you’re content with the selected inputs and credit costs.
Your video will begin processing in your current session, where each video will be available for review once complete.
Understanding Act-One Pricing
Act-One charges 10 credits per second with a minimum of 5 seconds. This means that driving performance videos under 5s will result in a charge of 50 credits.
After the 5 second minimum, each additional second is charged 10 credits, with partial seconds accounted for and rounded up to the nearest decimal. In example, a 5.6s driving performance would be charged 56 credits.
Reiterating and Troubleshooting
重申和故障排除
Most issues or errors will be specific to your driving performance or character reference image inputs and can be resolved by ensuring that the inputs follow the recommended best practices.
Below is a list of Act-One errors and how to troubleshoot them:
Error Troubleshooting 故障排除
Unable to detect a human face in your video. Ensure driving performance is properly lit and the face is unobscured and centered in frame.
Unable to detect a human face in your image. Ensure character image follows best practices.
确保字符图像遵循最佳实践。
An error occurred while detecting a human face in your video. Please try again later.
在检测您的视频中的人脸时出现错误。请稍后重试。 Ensure driving performance contains minimal body and background movement.
确保驾驶表现中包含最少的身体和背景移动。
We detected unusable audio from your video.
我们检测到您的视频中有不可用的音频。 Ensure the audio of your driving performance complies with our Trust & Safety standards.
确保您的驾驶表现的音频符合我们的信任与安全标准。
This content was flagged by our moderation policy.
此内容被我们的审核政策标记。 Ensure the character image complies with our Trust & Safety standards.
确保字符图像符合我们的信任与安全标准。
There may be cases where you don’t encounter an error before generation but receive an issue in your output. These edge cases can generally be resolved by following the best practices or re-running a generation:
可能在生成之前不会遇到错误,但在输出中会遇到问题的情况。这些边缘情况通常可以通过遵循最佳实践或重新运行生成来解决。
Issue 问题 Troubleshooting 故障排除
Face improperly detected
面部检测错误 Use a character image that follows best practices.
使用遵循最佳实践的字符图像。
Intermittent artifacts 断续的文物 Re-run the generation.
<?php
/**
* API请求DEMO
*
* 本demo支持GET与POST请求,同时支持签名验证与无需签名。
*/
//你申请的key密钥
$API_KEY = '你的接口密钥,登录控制台后在密钥管理页面申请';
//API接口地址
$API_URL = 'https://duomiapi.com/api/video/runway/pro/act_one';
$get_post_data = array(
//接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
'key' => $API_KEY,
'参数名' => '参数值',
);
//签名校验的 SK:(在用户控制台https://duomiapi.com/user/key的秘钥安全设置->签名校验 开启后才会生效,没开启签名校验留空即可。)
$sk = '56777ab62ff752fbd57ab7228fc2fc43';
/*发起请求API接口:
第1个参数:API接口地址URL,跟上面的同名变量相对应,无需更改。
第2个参数:API接口参数数组,跟上面的同名变量相对应,无需更改。
第3个参数:请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
第4个参数:是否验证签名,true验证签名,否则false不验证签名,根据用户控制台 https://duomiapi.com/user/key 的 秘钥安全设置->签名校验 开启后才会生效,如没开启,填写false即可。
第5个参数:如果第4个参数开启验证签名,此处必须填写 SK ,跟上面的同名变量相对应,无需更改。
*/
$resdata = api::send($API_URL, $get_post_data, 'GET', true, $sk); //发起请求,注意这里要选择接口支持的协议,默认GET,可选POST
//打印请求结果
print($resdata);
///////////////你的业务代码可写在这里处理API返回的数据
/**
* API请求类
*/
class api
{
public static function send($API_URL, $get_post_data, $type, $ifsign, $sk)
{
$get_post_data = http_build_query($get_post_data);
if ($ifsign) {
$sign = md5($get_post_data . $sk);
$res = self::send_curl($API_URL, $type, $get_post_data, $sign);
} else {
$res = self::send_curl($API_URL, $type, $get_post_data, null);
}
return $res;
}
//封装好的CURL请求函数,支持POST|GET
public static function send_curl($API_URL, $type, $get_post_data, $sign)
{
$ch = curl_init();
if ($type == 'POST') {
curl_setopt($ch, CURLOPT_URL, $API_URL);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
} elseif ($type == 'GET') {
curl_setopt($ch, CURLOPT_URL, $API_URL . '?' . $get_post_data);
}
if ($sign) {
curl_setopt($ch, CURLOPT_HTTPHEADER, ['sign:' . $sign]);
}
curl_setopt($ch, CURLOPT_REFERER, $API_URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$resdata = curl_exec($ch);
curl_close($ch);
return $resdata;
}
}
//jQuery-Ajax
$.ajax({
url: 'https://duomiapi.com/api/video/runway/pro/act_one',
data: {
//接口参数,一行一个,可按照接口文档-请求参数 的参数填写,或者直接复制开发工具下面的测试代码。
key: '你的接口密钥,登录控制台后在密钥管理页面申请',
参数名: '参数值',
},
type: 'GET', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
dataType: 'json',
success: function(data) {
console.log(data); //请求成功,输出结果到控制台
},
timeout: 3000, //超时时间
error: function(data) {
console.log('请求失败'); //失败处理
}
});
子程序名 | 返回值类型 | 公开 | 备 注 | ||
__启动窗口_创建完毕 |
子程序名 | 返回值类型 | 公开 | 备 注 | ||
Send_API |
变量名 | 类 型 | 静态 | 数组 | 备 注 | ||
REQU_Data | 文本型 | 提交字符串 | ||||
return | 文本型 | 返回字符串 | ||||
API_URL | 文本型 | 接口地址 | ||||
API_KEY | 文本型 | 接口密钥 |
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Test {
public static void main(String[] args) {
try {
URL url = new URL("https://duomiapi.com/api/video/runway/pro/act_one?key=你的接口密钥,登录控制台后在密钥管理页面申请");
HttpURLConnection connection = (HttpURLConnection)url.openConnection();
// 设置请求方式
connection.setRequestMethod("GET");
connection.connect();
// 获取响应码
int responseCode = connection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
String line;
while ((line = reader.readLine()) != null) {
// 读取到的内容给line变量
System.out.println(line);
}
reader.close();
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// 发起一个GET请求
resp, err := http.Get("https://duomiapi.com/api/video/runway/pro/act_one?key=你的接口密钥,登录控制台后在密钥管理页面申请")
if err != nil {
fmt.Println("http get error", err)
return
}
// 读取响应结果
result, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("http read error", err)
return
}
// 关闭响应结果
defer resp.Body.Close()
fmt.Println(string(result))
}
```
# 导入requests库
import requests
# 设置url
url = 'https://duomiapi.com/api/video/runway/pro/act_one?key=你的接口密钥,登录控制台后在密钥管理页面申请'
# 发送post请求
response = requests.post(url, data={'key1': 'value1', 'key2': 'value2'})
# 获取响应内容
result = response.json()
# 打印结果
print(result)
```
// 以下是使用Node.js进行GET和POST请求API接口的示例代码:
const https = require('https');
const querystring = require('querystring');
// 定义请求选项
const options = {
hostname: 'duomiapi.com',
path: '/api/video/runway/pro/act_one',
method: 'GET'
};
// 发送GET请求
https.get(options, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
}).on('error', error => {
console.error(error);
});
// 发送POST请求
const postData = querystring.stringify({
'key1': 'value1',
'key2': 'value2'
});
const postOptions = {
hostname: 'duomiapi.com',
path: '/api/video/runway/pro/act_one',
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': Buffer.byteLength(postData)
}
};
const postReq = https.request(postOptions, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
});
postReq.on('error', error => {
console.error(error);
});
postReq.write(postData);
postReq.end();
/*
这个示例代码使用Node.js内置的`https`模块进行HTTP请求。
首先定义了一个GET请求的选项,然后使用`https.get()`方法发送了GET请求。在响应流上注册回调函数,以便在收到响应数据时将其输出到控制台。在出现错误时,也注册了错误处理程序。
类似地,我们也定义了一个POST请求选项,并使用`https.request()`方法发送它。需要在请求头中包含适当的`Content-Type`和`Content-Length`以确保服务器可以正确解析请求体。请求体由`write()`方法写入,并在请求结束时通过调用`end()`方法通知请求对象已经完成。
注意,此示例默认使用`querystring`模块将数据作为x-www-form-urlencoded格式进行编码。如果需要使用其他格式(如JSON),则需要相应地更改请求头和请求体的编码方式。
另外,为了确保HTTPS请求的安全性,您也可以添加其他选项,例如验证服务器证书、设置代理等。
*/
以下是使用C语言进行GET和POST请求API接口的示例代码:
``` c
#include
#include
#include
#include // 需要安装curl库
// API地址
const char* url = "https://duomiapi.com/api/video/runway/pro/act_one";
// GET请求
void getRequest(CURL* curl) {
CURLcode res;
// 设置URL
curl_easy_setopt(curl, CURLOPT_URL, url);
// 执行请求
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
// POST请求
void postRequest(CURL* curl) {
CURLcode res;
// 设置URL
curl_easy_setopt(curl, CURLOPT_URL, url);
// 设置POST数据
const char* postData = "key=你的接口密钥,登录控制台后在密钥管理页面申请&key1=value1";
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
// 执行请求
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
int main() {
CURL* curl;
CURLcode res;
// 初始化curl
curl = curl_easy_init();
if(curl) {
// 设置SSL验证
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
// GET请求
getRequest(curl);
// POST请求
postRequest(curl);
// 清理curl资源
curl_easy_cleanup(curl);
}
return 0;
}
```
这个示例代码使用了libcurl库进行HTTP请求。
首先,需要设置API地址。然后,基于`CURL`结构体创建curl句柄,并使用`curl_easy_setopt()`函数设置选项。这里设置了SSL验证,以确保请求的安全性。
在GET请求中,只需将URL设置为选项,然后调用`curl_easy_perform()`函数执行请求即可。
在POST请求中,还需要将POST数据作为字符串传递给`CURLOPT_POSTFIELDS`选项。
需要注意的是,为了避免内存泄漏,应该在使用完curl句柄之后调用`curl_easy_cleanup()`函数进行清理。
除了上述示例代码外,libcurl库还提供了更多高级选项,例如处理HTTP头、上传文件等。可以参考文档进行更详细的了解。
以下是一个使用C++请求API接口的示例代码:
```cpp
#include
#include
int main() {
CURL *curl;
CURLcode res;
std::string url = "https://duomiapi.com/api/video/runway/pro/act_one?key=你的接口密钥,登录控制台后在密钥管理页面申请";
std::string response;
curl = curl_easy_init();
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, [](char *ptr, size_t size, size_t nmemb, void *userdata) -> size_t {
std::string *response = reinterpret_cast(userdata);
response->append(ptr, size * nmemb);
return size * nmemb;
});
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
res = curl_easy_perform(curl);
if (res == CURLE_OK) {
std::cout << "Response: " << response << std::endl;
} else {
std::cerr << "Error: " << curl_easy_strerror(res) << std::endl;
}
curl_easy_cleanup(curl);
}
return 0;
}
```
解释:
1. 引入需要的头文件:``用于输出结果,``用于使用libcurl库。
2. 定义需要请求的API接口的URL和存储响应数据的字符串变量。
3. 初始化一个CURL对象。
4. 设置CURL对象的参数:请求的URL(`CURLOPT_URL`)、是否跟随重定向(`CURLOPT_FOLLOWLOCATION`)、响应数据的写入函数(`CURLOPT_WRITEFUNCTION`)和响应数据的写入位置(`CURLOPT_WRITEDATA`)。
5. 发送HTTP请求并获取响应数据,判断返回状态码是否OK。
6. 清理CURL对象。
运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装libcurl库。
以下是一个使用C#请求API接口的示例代码:
```csharp
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main(string[] args) {
HttpClient client = new HttpClient();
string url = "https://duomiapi.com/api/video/runway/pro/act_one?key=你的接口密钥,登录控制台后在密钥管理页面申请";
HttpResponseMessage response = await client.GetAsync(url);
if (response.IsSuccessStatusCode) {
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine("Response: " + responseBody);
} else {
Console.WriteLine("Error: " + response.StatusCode);
}
}
}
```
解释:
1. 引用需要的命名空间:`System.Net.Http`用于使用HttpClient类,`System.Threading.Tasks`用于异步执行请求操作。
2. 创建一个HttpClient对象。
3. 定义需要请求的API接口的URL。
4. 发送GET请求到指定的API接口URL,并获取响应结果。
5. 判断响应状态是否成功,如果成功则读取响应数据(使用ReadAsStringAsync方法),否则输出错误信息(使用StatusCode属性)。
运行该程序会发送GET请求到指定的API接口URL,并在程序终止前将响应数据输出到终端。注意,在使用该示例代码之前需要安装.NET Framework或.NET Core SDK。
以下是VB请求API接口的示例代码:
```
' 1. 引入Microsoft XML v6.0库
' 2. 创建一个XMLHTTP对象
Dim xhr As XMLHTTP
Set xhr = New XMLHTTP
' 3. 设置请求的URL、方法,以及是否异步等
xhr.Open "GET", "https://duomiapi.com/api/video/runway/pro/act_one?key=你的接口密钥,登录控制台后在密钥管理页面申请", False
' 4. 发送请求
xhr.send
' 5. 获取响应结果
Dim responseText As String
responseText = xhr.responseText
' 6. 输出响应结果
Debug.Print responseText
' 7. 释放资源
Set xhr = Nothing
```
在这个示例中,我们创建了一个XMLHTTP对象,用于请求API接口。我们先调用`open`方法来设置请求的URL、方法,以及是否异步。然后,我们发送请求,并使用`responseText`属性来获取响应结果。最后,我们将响应结果打印到控制台,完成操作后释放资源,以防止内存泄漏。请注意,以上示例代码为同步请求,如果想使用异步请求,需要设置第三个参数为`True`,并在请求结束时处理`OnReadyStateChange`事件。
请 登录 后发表评论
填写业务相关参数免费在线调试
生成符合你的开发语言代码,复制即可
调整你后端部分逻辑代码即可上线使用
客服微信
joieme
请打开手机微信,扫一扫联系我们
返回顶部