> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Imagine Video 视频编辑

这是一个异步 API，仅返回异步任务的 `task_id`。

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/docs/models/reference-get-async-task-result) 来检索生成结果。
</Tip>

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="video" type="string" required={true}>
  要编辑的输入视频 URL。视频将被缩放至最大 854x480 像素，并截断至 8 秒。输入时长上限为 8.7 秒，输出保留原始视频的时长。必须为可公开访问的 URL。
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  期望的编辑效果的文本描述。描述要应用到输入视频的风格变换或内容更改，例如「将视频改为动漫风格」或「使其看起来像水彩画」。

  长度限制：1 - 4096
</ParamField>

<ParamField body="resolution" type="string" default="480p">
  输出视频分辨率。480p 生成更快，720p 画质更高。输出分辨率匹配输入分辨率，最高不超过所选值。

  可选值：`480p`, `720p`
</ParamField>

## 响应信息

<ResponseField name="task_id" type="string" required={true}>
  使用 task\_id 请求 [查询任务结果 API](/docs/models/reference-get-async-task-result) 来检索生成的输出。
</ResponseField>