xai-grok-imagine-video

用途：通过 xAI 直接 API（https://api.x.ai，需服务端使用 Authorization: Bearer $XAI_API_KEY）将视频生成作为受控的媒体生产流程，涵盖文生视频、图生视频、多参考图生视频、视频编辑与视频扩展五种模式，一次请求只能启用一种模式。主要能力：文生视频用 grok-imagine-video，时长 1–15 秒；图生视频可选基础模型或 grok-imagine-video-1.5（仅图生视频，支持 1080p）；参考图生视频仅基础模型支持，1–7 张参考图；编辑与扩展仅基础模型支持，输入分别不超过 8.7 秒与 2–15 秒，输出分辨率上限 720p。生成宽高比支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3，默认 16:9；默认分辨率 480p。用法：先冻结创意简报与素材权利，按价格表（如基础模型 480p 每秒 $0.05、720p 每秒 $0.07；1.5 模型 1080p 每秒 $0.25）计算报价，在本地演练并持久化意图记录后再发起付费 POST；完成后以 usage.cost_in_usd_ticks 核对实际费用。限制：创建接口无幂等键，超时或 5xx 时不得自动重试，应记录状态未知并核对账单；文档中速率限制存在冲突，运营上限未知；音频、帧率等参数未在 REST schema 中记录；图像文件大小文档存在 48MB 与 50MB 冲突。适用场景：需要可审计、可计费、可追溯的短视频批量生产与治理。