文生视频
文生视频,简单来说就是“通过提示词生成视频”。你只需要输入一段描述性的文字,比如“一只猫在夕阳下的草地上奔跑”,文生视频功能就能自动理解你的意思,并生成一段对应的动态视频画面。
MaaS支持模型以及相关参数,请参见支持模型。
支持模型
| model参数(模型 ID) | 支持能力 | 输入输出限制 | 默认限流 |
|---|---|---|---|
| pixverse/pixverse-v6-t2v | 文生视频 | 输入类型:文本 最大输入限制:文本 5000 字符 输出视频格式:MP4 输出视频最高分辨率:1080p 输出视频时长:1s~15s,可选。 | RPM: 30 |
| vidu/viduq3-pro_text2video | 文生视频 | 输入类型:文本 最大输入限制:文本 5000 字符 输出视频格式:MP4 输出视频帧率(fps):24 输出视频最高分辨率:1080p 输出视频时长:1s~16s,可选。 | RPM: 30 |
| vidu/viduq3-turbo_text2video | 文生视频 | 输入类型:文本 最大输入限制:文本 5000 字符 输出视频格式:MP4 输出视频帧率(fps):24 输出视频最高分辨率:1080p 输出视频时长:1s~16s,可选。 | RPM: 30 |
API说明
模型调用的完整参数列表请见生数科技创建文生视频任务以及爱诗科技创建文生视频任务。
使用限制
- 任务数据(如任务状态、视频URL等)仅保留24小时,超时后会被自动清除。请您务必及时保存生成的视频。
- 不同模型的限制值不同,具体限制值请以MaaS控制台“在线推理>预置服务”页面的模型限流列为准。
- TPM:每分钟处理的Tokens数(输入+输出)。
- RPM:每分钟处理的请求数。
- 目前华为云内部客户不支持开通三方服务。
前提条件
- 已在页签开通预置服务。详情请见开通MaaS预置服务。
- (可选)如果需要控制服务调用流量,可提前创建自定义接入点(三方模型暂不支持创建自定义接入点),详情请参见创建自定义接入点。
- 已获取API Key。详情请见管理API Key。
- 已获取模型服务的model参数值。详情请见支持模型。
输入输出示例
通过一句话或一段话即可生成视频,视频呈现丰富的艺术风格及影视级画质。
| 提示词 | 视频效果示例 |
|---|---|
| 一只猫在咖啡厅里看书。 |
|
| 一只猫戴着黑框眼镜在咖啡厅看书,书本放在桌子上,桌子上还有一杯咖啡,冒着热气,旁边是咖啡厅的窗户。 |
|
| 镜头中景拍摄,背景虚化,氛围光照,一只猫戴着黑框眼镜在咖啡厅看书,书本放在桌子上,桌子上还有一杯咖啡,冒着热气,旁边是咖啡厅的窗户,电影级调色。 |
|
创建文生视频(生数科技)
此处以使用ViduQ3-Pro T2V模型通过Python脚本和Curl命令生成视频为例,展示文本生成视频的基本用法。
1. 创建视频生成任务。
import requests
import json
if __name__ == '__main__':
url = "https://api.modelarts-maas.com/v1/video/generations" # API地址
api_key = "MAAS_API_KEY" # 把 MAAS_API_KEY 替换成已获取的API Key
# Send request.
headers = {
'Content-Type': 'application/json',
'Authorization': f'Bearer {api_key}'
}
data = {
"model": "vidu/viduq3-pro_text2video",
"input": {
"prompt": "小猫在散步"
},
"parameters": {
"size": "1280*720",
"duration": 5,
"audio": False
}
}
response = requests.post(url, headers=headers, data=json.dumps(data), verify=False)
# Print result.
print(response.status_code)
print(response.text) 响应示例
{
"task_id" : "964395715545571329"
} curl -X POST "https://api.modelarts-maas.com/v1/video/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MAAS_API_KEY" \
-d '{
"model": "vidu/viduq3-pro_text2video",
"input": {
"prompt": "小猫在散步"
},
"parameters": {
"size": "1280*720",
"duration": 5,
"audio": false
}
}' 响应示例
{
"task_id" : "964395715545571329"
} 2. 根据视频生成任务id获取视频。
视频生成为异步接口,您需要先创建视频生成任务,再通过视频生成任务的ID去查询视频生成结果。视频生成过程耗时较长,查询结果时请您耐心等待。
import requests
import json
if __name__ == '__main__':
url = "https://api.modelarts-maas.com/v1/video/generations/{task_id}" # API地址。请将task_id替换为实际的ID,您可以通过创建视频生成任务API获取。
api_key = "MAAS_API_KEY" # 把MAAS_API_KEY替换成已获取的API Key
# Send request.
headers = {
'Content-Type': 'application/json',
'Authorization': f'Bearer {api_key}'
}
response = requests.get(url, headers=headers, verify=False)
# Print result.
print(response.status_code)
print(response.text) {
"task_id" : "964395715545571329",
"status" : "succeeded",
"error" : null,
"content" : {
"result_url" : "https://example.com/example.mp4"
},
"usage" : {
"duration" : 5,
"size" : "1280*720",
"audio" : false,
"shot_type" : "single"
},
"created_at" : 1780281309530,
"updated_at" : 1780281338634
} curl -X GET 'https://api.modelarts-maas.com/v1/video/generations/task_id' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $MAAS_API_KEY"
{
"task_id" : "964395715545571329",
"status" : "succeeded",
"error" : null,
"content" : {
"result_url" : "https://example.com/example.mp4"
},
"usage" : {
"duration" : 5,
"size" : "1280*720",
"audio" : false,
"shot_type" : "single"
},
"created_at" : 1780281309530,
"updated_at" : 1780281338634
} 创建文生视频(爱诗科技)
此处以使用PixVerse V6 T2V模型通过Python脚本和Curl命令生成视频为例,展示文本生成视频的基本用法。
1. 创建视频生成任务。
import requests
import json
if __name__ == '__main__':
url = "https://api.modelarts-maas.com/v1/video/generations" # API地址
api_key = "MAAS_API_KEY" # 把 MAAS_API_KEY 替换成已获取的API Key
# Send request.
headers = {
'Content-Type': 'application/json',
'Authorization': f'Bearer {api_key}'
}
data = {
"model": "pixverse/pixverse-v6-t2v",
"input": {
"prompt": "小猫在散步"
},
"parameters": {
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"audio": False
}
}
response = requests.post(url, headers=headers, data=json.dumps(data), verify=False)
# Print result.
print(response.status_code)
print(response.text) 响应示例
{
"task_id": "408884082825756",
"resolution": "720p",
"duration": 5,
"audio": false
} curl -X POST "https://api.modelarts-maas.com/v1/video/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MAAS_API_KEY" \
-d '{
"model": "pixverse/pixverse-v6-t2v",
"input": {
"prompt": "小猫在散步"
},
"parameters": {
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"audio": false
}
}' 响应示例
{
"task_id": "408884082825756",
"resolution": "720p",
"duration": 5,
"audio": false
} 2. 根据视频生成任务id获取视频。
视频生成为异步接口,您需要先创建视频生成任务,再通过视频生成任务的ID去查询视频生成结果。视频生成过程耗时较长,查询结果时请您耐心等待。
import requests
import json
if __name__ == '__main__':
url = "https://api.modelarts-maas.com/v1/video/generations/{task_id}" # API地址。请将task_id替换为实际的ID,您可以通过创建视频生成任务API获取。
api_key = "MAAS_API_KEY" # 把MAAS_API_KEY替换成已获取的API Key
# Send request.
headers = {
'Content-Type': 'application/json',
'Authorization': f'Bearer {api_key}'
}
response = requests.get(url, headers=headers, verify=False)
# Print result.
print(response.status_code)
print(response.text) {
"task_id" : "408884082825756",
"status" : "succeeded",
"error": {
"code": 0,
"message": ""
},
"content" : {
"result_url" : "https://example.com/example.mp4"
},
"usage" : {
"duration" : 5,
"audio" : false,
"resolution": "720p"
},
"created_at" : 1780281309530,
"updated_at" : 1780281338634
} curl -X GET 'https://api.modelarts-maas.com/v1/video/generations/task_id' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $MAAS_API_KEY"
{
"task_id" : "408884082825756",
"status" : "succeeded",
"error": {
"code": 0,
"message": ""
},
"content" : {
"result_url" : "https://example.com/example.mp4"
},
"usage" : {
"duration" : 5,
"audio" : false,
"resolution": "720p"
},
"created_at" : 1780281309530,
"updated_at" : 1780281338634
} 相关文档
更多文生视频提示词优化指南请参见文本生成视频提示词。


