功能说明
对应工具标识video_generate。
video_generate 根据文本描述生成视频。下面的示例先用 image_generate 生成首帧与尾帧,再合成视频。
导入路径:from veadk.tools.builtin_tools.video_generate import video_generate
环境变量与前提
环境变量:MODEL_VIDEO_API_KEY:视频生成模型的 API Key;未设置时依次回退到MODEL_AGENT_API_KEY和配置文件中的model.api_keyMODEL_AGENT_API_KEY:智能体推理模型的 API KeyMODEL_VIDEO_NAME:视频生成模型名称MODEL_VIDEO_API_BASE:视频生成模型 API 地址,默认为火山方舟端点MODEL_IMAGE_NAME:图像生成模型名称
凭证在工具执行时解析,而非导入时。导入工具模块不会触发客户端初始化,也不会要求凭证已配置。
config.yaml 配置项:
config.yaml
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 应查看错误。查询与生成需使用同一服务地址和有权限的凭证