文档首页/ MaaS模型即服务/ 模型调用/ 视频生成/ 参考生视频
更新时间：2026-09-29 GMT+08:00
查看PDF
分享

参考生视频

基于参考图像和文本提示词生成视频。例如，以一张或者多张静态图片作为基础，通过模型根据这张图片的内容、风格或结构，生成一段动态视频。简单来说，就是让一张或者多张“静止的画”动起来，或者基于这张图的创意延伸出新的视频画面。MaaS支持模型以及相关参数，请参见支持模型。

支持模型

表1 三方模型

model参数（模型 ID）

支持能力

输入输出限制

默认限流

pixverse/pixverse-v6-r2v

参考生视频

输入类型：文本+图片

最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。

输出视频格式：MP4

输出视频帧率（fps）：24

输出视频时长：1s～15s，可选。

RPM: 30

vidu/viduq3-turbo_reference2video

参考生视频

输入类型：文本+图片

最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。

输出视频格式：MP4

输出视频帧率（fps）：24

输出视频最高分辨率：1080p

输出视频时长：1s～16s，可选。

RPM: 30

vidu/viduq3-mix_reference2video

参考生成视频

输入类型：文本+图片

最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。

输出视频格式：MP4

输出视频帧率（fps）：24

输出视频最高分辨率：1080p

输出视频时长：1s～15s，可选。

RPM: 30

vidu/viduq3-ad_reference2video

参考生成视频

输入类型：文本+图片

最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。

输出视频格式：MP4

输出视频帧率（fps）：24

输出视频最高分辨率：1080p

输出视频时长：1s～15s，可选。

RPM: 30

前提条件

  • 已获取模型服务的model参数值。详情请见支持模型。

使用限制

  • 任务数据（如任务状态、视频URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的视频。
  • 不同模型的限制值不同，具体限制值请以MaaS控制台“在线推理>预置服务”页面的模型限流列为准。
    • TPM：每分钟处理的Tokens数（输入+输出）。
    • RPM：每分钟处理的请求数。
  • 目前三方服务仅支持个人用户开通。

API说明

模型调用的完整参数列表请见生数科技创建参考生成视频任务以及爱诗科技创建参考生成视频任务。

输入输出示例

ViduQ3-Turbo IT2V模型将输入图片作为参考，再根据提示词生成视频。视频呈现丰富的艺术风格及高质量画质。

表2 参考图生视频效果示例

提示词

参考图片

视频

参考图片生成一幅，明月高悬，微风习习，树上的梅花花瓣随风而落，女子的长发也随风飘动。

明月高悬，微风习习，树上的梅花花瓣随风而落，图1女子的长发随风飘动。镜头右移，图2的男子缓缓走来。

创建参考生视频（生数科技）

此处以使用ViduQ3-Turbo R2V模型通过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-turbo_reference2video",
        "input": {
        "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。",
        "media": [
           {
               "type": "image_url",
               "url": "https://example/image1.jpg"
           },
          {
              "type": "image_url",
              "url": "https://example/image2.jpg"
          },
         {
             "type": "image_url",
             "url": "https://example/image3.jpg"
         }
       ]
   },
   "parameters": {
       "size": "1280*720",
       "duration": 5,
       "audio": True
    }
 }
    response = requests.post(url, headers=headers, data=json.dumps(data), verify=False)

    # Print result.
    print(response.status_code)
    print(response.text)

响应示例

{
  "task_id" : "962939796957712384"
}
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-turbo_reference2video",
   "input": {
       "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。",
       "media": [
          {
              "type": "image_url",
              "url": "https://example/image1.jpg"
          },
         {
             "type": "image_url",
             "url": "https://example/image2.jpg"
         },
        {
            "type": "image_url",
            "url": "https://example/image3.jpg"
       }
      ]
   },
   "parameters": {
       "size": "1280*720",
       "duration": 5,
       "audio": true
   }
 }'

响应示例

{
  "task_id" : "962939796957712384"
}

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"  # 把yourApiKey替换成已获取的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" : "962939796957712384",
  "status" : "succeeded",
  "error" : null,
  "content" : {
    "result_url" : "https://example.com/example.mp4"
  },
  "usage" : {
    "duration" : 5,
    "size" : "1280*720",
    "audio" : true,
    "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" : "962939796957712384",
  "status" : "succeeded",
  "error" : null,
  "content" : {
    "result_url" : "https://example.com/example.mp4"
  },
  "usage" : {
    "duration" : 5,
    "size" : "1280*720",
    "audio" : true,
    "shot_type" : "single"
  },
  "created_at" : 1780281309530,
  "updated_at" : 1780281338634
}

创建参考生视频（爱诗科技）

此处以使用PixVerse V6 R2V模型通过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-r2v",
   "input": {
  "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群@sheep 缓慢走动，远处有连绵青山。",
  "media": [
    {
   "type": "image_url",
   "url": "https://example/image1.jpg"
    },
    {
   "type": "image_url",
   "url": "https://example/image2.jpg"
    },
    {
   "type": "image_url",
   "url": "https://example/image3.jpg",
                        "ref_name": "sheep"
    }
  ]
   },
   "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": "408913047245542",
    "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-r2v",
   "input": {
  "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群@sheep 缓慢走动，远处有连绵青山。",
  "media": [
    {
   "type": "image_url",
   "url": "https://example/image1.jpg"
    },
    {
   "type": "image_url",
   "url": "https://example/image2.jpg"
    },
    {
   "type": "image_url",
   "url": "https://example/image3.jpg",
                        "ref_name": "sheep"
    }
  ]
   },
   "parameters": {
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "audio": false
   }
 }'

响应示例

{
    "task_id": "408913047245542",
    "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"  # 把yourApiKey替换成已获取的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": "408913047245542",
    "status": "succeeded",
    "error": {
        "code": 0,
        "message": ""
    },
    "content": {
        "result_url": "https://example.com/example.mp4"
    },
    "usage": {
        "duration": 5,
        "audio": false,
        "resolution": "720p"
    },
    "created_at": 1781786928000,
    "updated_at": 1781787020000
}
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": "408913047245542",
    "status": "succeeded",
    "error": {
        "code": 0,
        "message": ""
    },
    "content": {
        "result_url": "https://example.com/example.mp4"
    },
    "usage": {
        "duration": 5,
        "audio": false,
        "resolution": "720p"
    },
    "created_at": 1781786928000,
    "updated_at": 1781787020000
}

相关文档

更多图生视频提示词优化指南请参见图片生成视频提示词。

父主题： 视频生成

相关文档