2.2 KiB
2.2 KiB
1-h Video Provider (1h-video)
OpenClaw 视频生成驱动模块,适配标准 OpenAI Videos API(/v1/videos 规范)。
专为自建聚合网关或第三方中转(如 gemini-web2api-go、ccLoad)做了深度兼容修复:
- 任务创建:
POST /v1/videos。纯文本任务自动发送 JSON Body,避免第三方服务因不支持 Multipart 表单报 400 错误;带参考图/垫视频时使用标准 Multipart 表单。 - 状态轮询:
GET /v1/videos/{id}。兼容提取普通对象错误信息与字符串错误消息。 - 视频下载:
GET /v1/videos/{id}/content。流式下载 MP4 二进制视频流。 - 私有网络:原生支持私有/内网端点请求(
allowPrivateNetwork: true),兼容host.incus.internal、Tailnet 或局域网反代地址。
配置说明
支持通过 Web 控制台(Control UI) 或直接编辑 ~/.openclaw/openclaw.json。
方式 1:Web 控制台可视化配置
进入 Settings → Plugins → 1-h Tools:
- API Base URL:填写视频上游端点(例如
http://host.incus.internal:8083/v1或内部网关地址) - API Key:填写 API Key 或 SecretRef(留空时自动回退读取环境变量
OPENAI_VIDEO_API_KEY、CCLOAD_API_KEY或BIFROST_API_KEY) - 默认视频模型:例如
gemini-video或sora-2
方式 2:编辑 openclaw.json
在 ~/.openclaw/openclaw.json 中配置:
{
"plugins": {
"entries": {
"1h-tools": {
"enabled": true,
"config": {
"video": {
"baseUrl": "http://host.incus.internal:8083/v1",
"apiKey": "sk-your-video-key",
"defaultModel": "gemini-video",
"allowPrivateNetwork": true
}
}
}
}
},
"agents": {
"defaults": {
"mediaModels": {
"video": {
"primary": "1h-video/gemini-video"
}
}
}
}
}
使用方法
配置完成后,OpenClaw 内置的 video_generate 工具即可自动调度:
- 自然语言直接对话生成:
“帮我生成一个 5 秒的猫咪在海滩上奔跑的 16:9 视频”
- 垫图/图生视频: 在对话中上传或提供图片链接,提示助手基于该图生成视频。