本文介绍了如何使用边缘大模型网关平台预置的知识点视频生成智能体。

能力介绍 #

知识点视频生成智能体能够根据您输入的知识点文本，自动生成多种风格的讲解视频。该智能体尤其适用于 K12 教学场景，可将枯燥的文本知识转化为生动有趣的视频内容。

使用流程 #

要使用知识点视频生成智能体，您需要：

1. 创建一个网关访问密钥，并为该密钥绑定 知识点视频生成智能体。相关操作，请参见调用平台预置智能体。
2. 获取网关访问密钥的 API key。相关操作，请参见查看密钥（API Key）。
3. 调用知识点视频生成智能体 API 执行视频生成任务。关于如何使用 API，请参见 API 使用方法。

调用预览 #

使用知识点视频生成智能体前，您可以先通过预览功能体验其能力。预览只需要一个网关访问密钥即可。预览时发生的模型调用将会消耗所使用网关访问密钥的免费资源配额。

1. 登录边缘大模型网关控制台。

2. 在左侧导航栏，选择 模型配置管理 > 智能体管理。
3. 在 平台预置智能体 标签页，找到 知识点视频生成智能体，单击 操作 列的 调用预览。
4. 在 调用预览 面板，参照以下步骤来体验知识点视频生成智能体的能力：
   1. 选择视频风格要求，包括 学生类型、讲解风格、音色。
   2. 在 问题描述 输入框输入知识点描述。例如，“什么是重力加速度”。
   3. 选择要使用的 网关访问密钥。
   4. 单击 立即生成视频。

等待几分钟，即可在面板右侧观看生成的视频。您可根据需要下载或删除视频。

API 使用方法 #

提交视频生成任务 #

功能描述

提交一个知识点视频生成任务，智能体将根据请求参数异步生成视频。

接口信息

• 请求方法：POST
• Endpoint：https://ai-gateway.vei.volces.com/v1/contents/generations/tasks

请求参数

请求头参数

请求体参数

调用示例

cURL 请求示例

curl --location 'https://ai-gateway.vei.volces.com/v1/contents/generations/tasks' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $YOUR_API_KEY' \
--data '{
    "model": "AG-video-generate-agent",
    "content": [
        {
            "type": "text",
            "text": "什么是重力加速度 --student_type primary_school --teaching_style vivid_fun --voice_type zh_male_yangguangqingnian_moon_bigtts"
        }
    ]
  }'

Python 调用示例

import requests
import json

API_KEY = "您的API密钥"  # 替换为网关访问密钥的API Key
URL = "https://ai-gateway.vei.volces.com/v1/contents/generations/tasks"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

payload = {
    "model": "AG-video-generate-agent",
    "content": [
        {
            "type": "text",
            "text": "什么是重力加速度 --student_type primary_school --teaching_style vivid_fun --voice_type zh_male_yangguangqingnian_moon_bigtts"
        }
    ]
}

try:
    response = requests.post(
        url=URL,
        headers=headers,
        data=json.dumps(payload)
    )
    response.raise_for_status()
    result = response.json()
    print("请求成功，响应结果：")
    print(json.dumps(result, indent=2, ensure_ascii=False))

except requests.exceptions.RequestException as e:
    print(f"请求失败：{str(e)}")

返回结果

调用成功，返回任务 ID。任务在后台异步执行。您可使用返回的任务 ID 查询任务状态。

分页列出视频生成任务 #

功能描述

分页查询视频生成任务列表，支持按任务状态和任务 ID 过滤。

接口信息

• 请求方法：GET
• Endpoint：https://ai-gateway.vei.volces.com/v1/contents/generations/tasks

请求参数

请求头参数

查询参数

调用示例

cURL 请求示例

curl --location 'https://ai-gateway.vei.volces.com/v1/contents/generations/tasks' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $YOUR_API_KEY'

Python 调用示例

import requests
import json

API_KEY = "您的API密钥"  # 替换为网关访问密钥的API Key
URL = "https://ai-gateway.vei.volces.com/v1/contents/generations/tasks"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

try:
    response = requests.get(
        url=URL,
        headers=headers     )
        response.raise_for_status()  # 状态码为 4xx/5xx 时抛出异常
        result = response.json()
    print(result) 
except requests.exceptions.RequestException as e:
    print(f"请求失败：{str(e)}")

返回结果

items 列表包含的参数说明如下：

返回结果示例如下：

{
    "total": 1,
    "items": [
        {
            "id": "your_task_id",
            "model": "AG-video-generate-agent",
            "status": "completed",
            "prompt": "什么是重力加速度",
            "student_type": "primary_school",
            "teaching_style": "vivid_fun",
            "voice_type": "zh_male_yangguangqingnian_moon_bigtts",
            "created_at": 1678886400,
            "updated_at": 1678886460,
            "content": {
                "video_url": "https://your_video_url.mp4"
            },
            "usage": {
                "completion_tokens": 150,
                "prompt_tokens": 50,
                "total_tokens": 200
            }
        }
    ]
}

获取指定视频生成任务 #

功能描述

通过任务 ID 查询指定视频生成任务的状态和详细信息。

接口信息

• 请求方法：GET
• Endpoint：https://ai-gateway.vei.volces.com/v1/contents/generations/tasks/{task_id}

请求参数

路径参数

请求头参数

调用示例

cURL 请求示例

curl --location 'https://ai-gateway.vei.volces.com/v1/contents/generations/tasks/{your_task_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $YOUR_API_KEY'

Python 调用示例

import requests
import json

API_KEY = "您的API密钥"  # 替换为实际的 API Key
TASK_ID = "your_task_id"  # 替换为实际的任务 ID
URL = f"https://ai-gateway.vei.volces.com/v1/contents/generations/tasks/{TASK_ID}"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

try:
    response = requests.get(
        url=URL,
        headers=headers
    )
    response.raise_for_status()
    result = response.json()
    print("请求成功，任务详情：")
    print(json.dumps(result, indent=2, ensure_ascii=False))

except requests.exceptions.RequestException as e:
    print(f"请求失败：{str(e)}")

返回结果

返回结果的参数说明如下：

返回结果示例如下，结构同分页列出视频生成任务返回的 item：

{
    "id": "your_task_id",
    "model": "AG-video-generate-agent",
    "status": "completed",
    "prompt": "什么是重力加速度",
    "student_type": "primary_school",
    "teaching_style": "vivid_fun",
    "voice_type": "zh_male_yangguangqingnian_moon_bigtts",
    "created_at": 1678886400,
    "updated_at": 1678886460,
    "content": {
        "video_url": "https://your_video_url.mp4"
    },
    "usage": {
        "completion_tokens": 150,
        "prompt_tokens": 50,
        "total_tokens": 200
    }
}

删除视频生成任务 #

功能描述

通过任务 ID 删除指定的视频生成任务。

接口信息

• 请求方法：DELETE
• Endpoint：https://ai-gateway.vei.volces.com/v1/contents/generations/tasks/{task_id}

请求参数

路径参数

请求头参数

调用示例

cURL 请求示例

curl --location --request DELETE 'https://ai-gateway.vei.volces.com/v1/contents/generations/tasks/{your_task_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $YOUR_API_KEY'

Python 调用示例

import requests

API_KEY = "您的API密钥"  # 替换为实际的 API Key
TASK_ID = "your_task_id"  # 替换为要删除的任务 ID
URL = f"https://ai-gateway.vei.volces.com/v1/contents/generations/tasks/{TASK_ID}"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

try:
    response = requests.delete(
        url=URL,
        headers=headers
    )
        response.raise_for_status()  # 状态码 4xx/5xx 时抛出异常
        result = response.json()
    print("删除成功，响应结果：")
    print(json.dumps(result, indent=2, ensure_ascii=False))
except requests.exceptions.RequestException as e:
    print(f"删除失败：{str(e)}")

返回结果

调用成功，HTTP 状态码返回 200，表示删除成功。