Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

5.1 KB
Raw Blame

自定义供应商的 xAI 兼容视频接口

自定义 API、CPA/Sub2API 等 HTTP 中转只要提供同一视频协议,就共用 Core 已有的异步调用、持久化、轮询、下载和媒体入库流程。连接产品名、CLI 如何登录 不参与协议判断。内置网关与 SuperGrok 的既有路径保留。

配置

  1. 在供应商的连接设置中,选中持有视频 API 地址和 Key 的连接,勾选 「使用 xAI 兼容视频接口」。同一个供应商只保留一个明确的视频连接, 不改变图片连接或其他引擎的对话地址、模型、凭证。
  2. 模型清单缺少视频成员时,手动添加接口实际支持的模型 ID。在模型详情中选择 「文字生成视频」或「文字生成视频和图片转视频」。只有声明图片输入的模型 才进入 Art 的 Image-to-video 下拉。「跟随模型目录」删除用户类型与模态覆盖。
  3. 重新打开 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 执行两种操作, 保存受管视频、检查实际时长/画面、确认任务退出运行状态,并区分准备与生成耗时。