ModelScope文生视频 SDK API 可以集成到自已软件上吗？

是的，ModelScope文生视频 SDK API 可以集成到您自己的软件中。以下是详细的集成方法和步骤：

1. 集成前提条件

在使用文生视频 SDK API 之前，需要完成以下准备工作： - 开通服务：确保您已在阿里云平台开通了相关模型服务，并获取了 API Key。 - 配置 API Key：将获取的 API Key 配置到环境变量中，以便后续调用时使用。 - 安装 SDK：根据您的开发语言选择合适的 DashScope SDK 版本进行安装。目前支持 Python 和 Java。

2. 调用方式

文生视频 SDK 提供了两种调用方式：HTTP 调用 和 SDK 调用。您可以根据实际需求选择适合的方式。

2.1 HTTP 调用

HTTP 调用适用于不依赖特定编程语言的场景，但需要注意以下事项： - 异步处理：由于视频生成耗时较长（约 5-10 分钟），HTTP 调用仅支持异步获取结果。您需要分两步完成调用： 1. 创建任务：发送 POST 请求创建任务，返回任务 ID。 bash curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \ -H 'X-DashScope-Async: enable' \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "wanx2.1-t2v-turbo", "input": { "prompt": "一只小猫在月光下奔跑" }, "parameters": { "size": "1280*720" } }' 2. 查询任务结果：使用上一步返回的任务 ID，通过 GET 请求查询生成结果。 bash curl -X GET \ --header "Authorization: Bearer $DASHSCOPE_API_KEY" \ https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

2.2 SDK 调用

SDK 调用提供了更便捷的封装，支持同步和异步两种方式。以下是 Python SDK 的示例代码：

• 同步调用：

  from http import HTTPStatus
  from dashscope import VideoSynthesis
  
  def sample_sync_call_t2v():
    print('请稍等...')
    rsp = VideoSynthesis.call(
        model='wanx2.1-t2v-turbo',
        prompt='一只小猫在月光下奔跑',
        size='1280*720'
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)  # 输出生成的视频 URL
    else:
        print(f'调用失败, 状态码: {rsp.status_code}, 错误信息: {rsp.message}')
  
  if __name__ == '__main__':
    sample_sync_call_t2v()
  

• 异步调用： 异步调用与同步调用类似，但更适合长时间运行的任务。具体实现可参考 SDK 文档。

3. 模型选择

文生视频 API 提供了两种模型版本，您可以根据需求选择： - wanx2.1-t2v-turbo：生成速度更快，表现均衡，适合对生成时间有较高要求的场景。 - wanx2.1-t2v-plus：生成细节更丰富，画面质感更强，适合对视频质量有更高要求的场景。

4. 注意事项

• 免费额度与计费：
  • 每个主账号和 RAM 子账号共享免费额度：200 秒（有效期为百炼开通后 180 天内）。
  • 超出免费额度后，按以下单价计费：
  • wanx2.1-t2v-turbo：0.24 元/秒。
  • wanx2.1-t2v-plus：0.70 元/秒。
• 限流规则：
  • QPS 限制：每秒最多发起 2 次任务下发请求。
  • 同时处理任务数：最多允许 2 个任务同时处理。
• 视频下载时效：生成的视频 URL 有效期为 24 小时，请及时下载保存。

5. 集成建议

• 如果您的软件需要快速生成视频，建议优先使用 wanx2.1-t2v-turbo 模型。
• 对于需要高质量输出的场景，可以选择 wanx2.1-t2v-plus 模型。
• 在高并发场景下，请合理规划任务调度，避免超出限流规则导致请求失败。

通过以上步骤，您可以成功将 ModelScope 文生视频 SDK API 集成到您的软件中，并根据实际需求灵活调用相关功能。