Grok Imagine Video Edit

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "grok-imagine-video",
    "input": {
      "prompt": "a penguin walks away from the camera, towards a large snowy mountaintop in the distance"
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

6 fields in input, required first.

• promptRequired
  string

  Text prompt for video generation

• imageOptional
  URL

  Input image to generate video from (image-to-video). Supports jpg, jpeg, png, webp.

• videoOptional
  URL

  Input video to edit (video editing mode). Must be a direct link, max 8.7 seconds. Supports mp4, mov, webm.

• durationOptional
  integerDefault 5

  Duration of the video in seconds (1-15). Ignored when editing a video.

• aspect_ratioOptional
  auto, 16:9, 4:3, 1:1, 9:16, 3:4, 3:2, 2:3Default auto

  Aspect ratio of the video. For text-to-video, defaults to 16:9. For image-to-video, defaults to the input image's native aspect ratio. Ignored when editing a video.

• resolutionOptional
  720p, 480pDefault 720p

  Resolution of the video. Ignored when editing a video.