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

# Grok Video Edit

> xAI Grok · `grok-imagine-video-edit` · video

## Identifier

Use the model identifier `grok-imagine-video-edit` in the `model` field when calling [`/asset/start`](/api-reference/assets/start).

## Capabilities

| Property         | Value                                                              |
| ---------------- | ------------------------------------------------------------------ |
| Reference inputs | 1                                                                  |
| Input types      | `video`                                                            |
| Aspect ratios    | `16:9`, `4:3`, `3:2`, `1:1`, `2:3`, `3:4`, `9:16` (default `16:9`) |
| Resolutions      | `480p`, `720p` (default `720p`)                                    |
| Audio            | no                                                                 |
| Tags             | `video-edit`                                                       |

## Inputs

This model takes **named media inputs**. Pass each one as a top-level field in the request body (not inside `references`). Each field accepts exactly one of `url`, `asset_id`, or `avatar_id`.

| Field          | Type  | Required | Description                                                     |
| -------------- | ----- | -------- | --------------------------------------------------------------- |
| `source_video` | video | yes      | Video to edit. The prompt describes the modifications to apply. |

* `url` — a direct, publicly accessible file URL
* `asset_id` — the ID of an existing asset in your Hoox space (e.g. a previous generation)
* `avatar_id` — the ID of an avatar defined in your Hoox space

## Pricing

Default parameters (`720p`): **\~4 credits / generation**.

For exact pricing with your own parameters, call [`/asset/pricing`](/api-reference/assets/pricing) with the `model` and any parameters that affect cost.

## Example request

```json theme={null}
{
  "type": "video",
  "model": "grok-imagine-video-edit",
  "prompt": "Describe what you want to generate",
  "source_video": {
    "url": "https://example.com/reference.mp4"
  },
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

See [`/asset/start`](/api-reference/assets/start) for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.