Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
自定义供应商的 xAI 兼容视频接口
自定义 API、CPA/Sub2API 等 HTTP 中转只要提供同一视频协议,就共用 Core 已有的异步调用、持久化、轮询、下载和媒体入库流程。连接产品名、CLI 如何登录 不参与协议判断。内置网关与 SuperGrok 的既有路径保留。
配置
- 在供应商的连接设置中,选中持有视频 API 地址和 Key 的连接,勾选 「使用 xAI 兼容视频接口」。同一个供应商只保留一个明确的视频连接, 不改变图片连接或其他引擎的对话地址、模型、凭证。
- 模型清单缺少视频成员时,手动添加接口实际支持的模型 ID。在模型详情中选择 「文字生成视频」或「文字生成视频和图片转视频」。只有声明图片输入的模型 才进入 Art 的 Image-to-video 下拉。「跟随模型目录」删除用户类型与模态覆盖。
- 重新打开 Art 详情,为 Video generation、Image-to-video 选择该来源的模型。
连接地址接受 origin、/v1 或路径前缀,如 https://relay.example/proxy/v1;
没有 /v1 时追加,前缀保留。模型 ID 原样发送,不剥离或猜测厂商前缀。
协议与能力边界
| 阶段 | 接口 | 响应 |
|---|---|---|
| 生成/图生视频 | POST /videos/generations,JSON |
request_id |
| 查询原任务 | GET /videos/{request_id} |
status,完成为 done,失败为 failed/expired |
| 成品 | video.url |
公开 URL 走隔离下载;固定任务内容引用走原 API,分块读取 MP4、识别 MIME 并入仓 |
必填 prompt;图生视频再提供一张 image: {url},支持 Cindy 受管图片引用。
当前适配保守开放 1–15 秒、480p/720p/1080p 和协议支持的画幅。
可选参数不传则跟随上游默认;图生视频不默认写入 16:9,避免改变原图画幅。
显式 fps、音轨开关、尾帧、多参考图和其他字段会在付费提交前拒绝,不静默丢弃。
这些范围是本版适配边界,不代表所有同协议模型都具有相同能力。
依据:xAI 视频生成、 图片转视频。 OpenAI 官方 Sora Videos API 已于 2026-09-24 停止服务,本次不新增其适配器; 见 官方历史说明。 其他仍在使用该旧协议的中转、Gemini/Veo 原生协议及各厂商私有接口尚未适配。
兼容与失败恢复
videoApi: "xai-videos"是可选用户配置,缺省关闭;不自动改变已装 Art 的偏好、 批准记录、权限指纹或付费来源。此次改动属于客户端,无需更新 Art 包。- 视频与图片分别绑定明确的连接;同名模型不会从其他引擎借用 Key。多个明确来源 冲突时拒绝派发,在连接设置重新选择唯一视频来源即可恢复。
- 鉴权为该连接的 Bearer API Key,或仅回环的无鉴权。模型级地址必须同源,
带凭证的请求不跟随重定向。公开 URL 下载不携带生成凭证,未知来源走既有下载审批。
若结果是
/videos/<原任务ID>/content,只读取原连接下由已保存任务 ID 构造的固定 内容接口,使用原连接凭证,不解释任意 URL 为可带 Key 的地址,不跟随重定向。 此 API 资源读取同样分块落私有临时文件、校验归属、MIME 后入仓,并最多重试同一个 GET 三次。 写入按实际累计字节受可用磁盘预算限制,预留 256 MiB 和入库副本空间;写入前复查剩余空间。 超预算或无法探测空间时取消读取、清理临时文件,不自动重试下载,原任务结果保留。 - 调用快照保存连接的不可逆绑定摘要,不保存 Key/请求头;跨客户端重启保持绑定。 地址、Key、来源引擎或业务请求头变化时停止旧任务请求,恢复原连接后可查询原任务。
- 一次付费提交保存任务 ID,之后只查询它。完成响应先持久化,下载或入库恢复 不重新生成;签名地址过期时只刷新原任务。提交结果未知时禁止自动重提。 即使等待响应期间连接变化,已返回的有效任务 ID 仍先保存到原调用与原连接绑定下; 查询与下载继续要求原连接,恢复原连接即可继续读取,不向替换连接发送请求。
- 新付费请求在参考图读取和调用占用完成后,实际发出 POST 前再次检查模型、来源及能力。 若已停用或连接已改变则不提交,保留原 prepared 调用;恢复原配置后可继续使用同一调用。 已付费任务的查询与结果恢复不受展示/停用开关影响。 视频参数严格检查类型;受管参考图展开后再次校验图片 MIME,视频或音频不能作为图片提交。
- 新来源使用 Core 媒体能力;冻结的旧
cindy-request视频入口不扩展。 - 出现在目录或通过接口探测不等于真实出片。验收需分别从 Art 执行两种操作, 保存受管视频、检查实际时长/画面、确认任务退出运行状态,并区分准备与生成耗时。