跳转到主要内容
POST

请求参数

string
必填
视频生成模型名称:grok-imagine-video-1.5。
string
视频的文本描述,最多 100,000 UTF-8 字节。没有首帧、尾帧或关键帧时必填;可描述对白、环境声和音乐。
number
默认值:8
生成时长(秒),1–15 秒,默认 8 秒;具体时长须当前模型线路支持。
string
默认值:"16:9"
视频宽高比:1:1、16:9、9:16、4:3、3:4、3:2、2:3。
string
默认值:"720p"
视频分辨率:480p 或 720p。使用参考图、参考音频或关键帧时最高 720p。
object
首帧图片,例如 {"url":"https://example.com/first.jpg"}。使用图片 HTTP(S) URL、Data URL 或同一上游账户的 input_ 文件标识;url 与 file_id 二选一。
object
尾帧图片,格式同 image。
object[]
参考图片列表,最多 14 张;与首帧、尾帧、关键帧分别计数。示例:[{"url":"https://example.com/person.jpg"}]。
object[]
最多 4 个时间关键帧。每项提供 image 和 timestamp_s;时间须在视频内部,按 1/3 秒网格取整后不能与端点或其他关键帧重叠。示例:[{"image":{"url":"https://example.com/frame.jpg"},"timestamp_s":2}]。
object[]
最多 3 个参考音频对象:{"voice_id":"eve"}、{"url":"https://example.com/speech.wav"} 或 {"data":"<base64>","format":"mp3"}。音色 ID 不能与 URL 或 Base64 音频混用;支持 mp3、wav、m4a、aac、ogg、webm、flac,具体音色由当前线路决定。
number
duration 的别名;同时提供时两者须一致。
string
像素尺寸 1280x720 或 720x1280;映射为 720p 横屏或竖屏,不能与 aspect_ratio、resolution 冲突。
object
首帧 image 的别名,两者不能同时提供。multipart 可使用单张图片文件,文件不超过 20 MiB、请求体不超过 32 MiB。
string
用于标记请求用户的可选字符串。

返回说明

提交任务后返回 id、object、status 和 model。视频文件尚未生成时,请勿重复提交。使用 GET /v1/videos/{id} 查询状态;完成后通过 GET /v1/videos/{id}/content 获取视频。
string
任务 ID。
string
对象类型。
string
任务状态。
string
模型名称。
参数缺失、模型未启用或超出限制时返回 400。视频编辑使用 POST /v1/videos/edits。

视频延长

使用 POST /v1/videos/extensions,传入源视频的公网地址,从源视频末尾继续生成。
提交后返回任务 id;使用 GET /v1/videos/{id} 查询状态,完成后使用 GET /v1/videos/{id}/content 获取视频。按新增片段时长计费,不按最终成片总时长计费。