Skip to main content

功能说明

对应工具标识 video_generate。 video_generate 根据文本描述生成视频。下面的示例先用 image_generate 生成首帧与尾帧,再合成视频。 导入路径:from veadk.tools.builtin_tools.video_generate import video_generate

环境变量与前提

附加要求:
  1. 配置用于智能体推理模型的 API Key;
  2. 配置用于视频生成的模型名称(MODEL_VIDEO_NAME);
  3. 若使用首尾帧合成,还需配置图像生成模型名称(MODEL_IMAGE_NAME)。
环境变量:
  • MODEL_VIDEO_API_KEY:视频生成模型的 API Key;未设置时依次回退到 MODEL_AGENT_API_KEY 和配置文件中的 model.api_key
  • MODEL_AGENT_API_KEY:智能体推理模型的 API Key
  • MODEL_VIDEO_NAME:视频生成模型名称
  • MODEL_VIDEO_API_BASE:视频生成模型 API 地址,默认为火山方舟端点
  • MODEL_IMAGE_NAME:图像生成模型名称
凭证在工具执行时解析,而非导入时。导入工具模块不会触发客户端初始化,也不会要求凭证已配置。
config.yaml 配置项:
config.yaml
使用 BytePlus 时应按已开通服务显式设置对应的媒体模型名称、API 地址和 API Key;不要假定 CLOUD_PROVIDER 会覆盖这些媒体配置。图像或视频的能力与参数限制以所选模型服务为准。视频 API 地址与默认模型名在导入时确定,应在启动进程前配置

使用方法

examples/tools/video_generate/agent.py

参数与任务状态

每个请求必须有 video_name: str 与 prompt: str。其余字段未提供时使用服务默认行为: 返回结果包含 status、success_list、error_list、error_details 和 pending_list。成功项为视频名称到 URL 的映射;待处理项含 task_id,本地等待结束不会取消远端生成任务,不能直接重新提交以代替查询 video_task_query(task_id: str, tool_context: ToolContext) 接收必填任务 ID 和自动注入的上下文,没有可选参数,返回 status、video_url 和 error 等字段。queued、running 表示仍在执行,succeeded 且有 URL 才可交付,failed 应查看错误。查询与生成需使用同一服务地址和有权限的凭证
最后修改于 2026年9月19日