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

# Grok Imagine Video edit

This is an async API that only returns the `task_id` of the async task.

<Tip>
  This is an **async** API that only returns the task\_id of the async task. Use the task\_id to call the [Get Async Task Result API](/docs/models/reference-get-async-task-result) to retrieve the generated result.
</Tip>

## Request Headers

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

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format: Bearer \{\{API Key}}.
</ParamField>

## Request Body

<ParamField body="video" type="string" required={true}>
  Input video URL to edit. The video will be scaled to a maximum of 854x480 pixels and truncated to 8 seconds. Maximum input duration is 8.7 seconds; output retains the original video duration. Must be a publicly accessible URL.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Text description of the desired edit. Describe the style transformation or content changes to apply to the input video, such as "convert the video to anime style" or "make it look like a watercolor painting".

  Length limit: 1 - 4096
</ParamField>

<ParamField body="resolution" type="string" default="480p">
  Output video resolution. 480p generates faster; 720p provides higher quality. Output resolution matches the input resolution, up to the selected value.

  Possible values: `480p`, `720p`
</ParamField>

## Response

<ResponseField name="task_id" type="string" required={true}>
  Use the task\_id to call the [Get Async Task Result API](/docs/models/reference-get-async-task-result) to retrieve the generated output.
</ResponseField>