Skip to content

Grok Imagine Reference to Video

Integrate

Model id xai/grok-imagine-video/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-imagine-video/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.402 402 API credits your files are measured before the run Run it on this page

Get API key
xAI Reference to Video Reference inputs1–10 sup to 720p #video-edit#v2v#grok#xai

Generates video guided by 1 to 7 reference images tagged in the prompt as @Image1, @Image2

Made on Doitong

Public works made with Grok Imagine by the Doitong community. Reuse a prompt in one click.

Public works shown: 16
Струя воды из шланга неожиданно окатывает Анну с головы до ног. Она вздрагивает, зажмуривается и ... Video

Струя воды из шланга неожиданно окатывает Анну с головы до ног. Она вздрагивает, зажмуривается и пытается прикрыться руками, при этом комично роняя тяпку. Камера быстро зумирует на её промокшее лицо, фиксируя забавную гримасу. На заднем плане слышен приглушенный смех детей. Момент внезапности и...

Дети одновременно прыгают в бассейн, создавая огромный столб брызг, который летит прямо в сторону... Video

Дети одновременно прыгают в бассейн, создавая огромный столб брызг, который летит прямо в сторону камеры. Камера имитирует эффект замедленной съемки в момент полета, а затем резко ускоряется при ударе о воду. Вода разлетается мириадами сверкающих капель. Динамика кадра подчеркивает энергию и хаос...

Буня смешно подпрыгивает, пытаясь поймать бабочку зубами, его уши забавно хлопают на ветру. Камер... Video

Буня смешно подпрыгивает, пытаясь поймать бабочку зубами, его уши забавно хлопают на ветру. Камера движется параллельно собаке, создавая эффект слежения. Трава и цветы мелькают на переднем плане. Бабочка ловко уворачивается, заставляя песика крутиться на месте. Эмоция — чистая радость и игривость...

Анна медленно опускается в шезлонг, выдыхая с облегчением, и открывает книгу. Камера плавно наезж... Video

Анна медленно опускается в шезлонг, выдыхая с облегчением, и открывает книгу. Камера плавно наезжает на её лицо, запечатлевая момент долгожданного покоя. На заднем плане внезапно пролетает яркий мяч, нарушая идиллию. Ветер слегка колышет ветви деревьев, создавая игру теней на траве. Эмоция...

Камера стремительно отлетает назад и вверх, превращая сцену в грандиозную панораму. Певец продолж... Video

Камера стремительно отлетает назад и вверх, превращая сцену в грандиозную панораму. Певец продолжает петь припев, его голос словно сливается с шумом волн. Вода внизу движется хаотично и мощно, разбиваясь о непоколебимые скалы. Облака в небе быстро движутся, создавая игру света и тени на...

Певец поет с нарастающей страстью, его мимика передает каждое слово песни. Он медленно закрывает ... Video

Певец поет с нарастающей страстью, его мимика передает каждое слово песни. Он медленно закрывает глаза на мгновение, а затем открывает их, наполненных светом. Камера плавно приближается к его лицу, фокусируясь на эмоциях. В фоне заметно легкое движение облаков и мерцание моря, создающее ощущение...

Певец начинает петь первую строку, его губы четко артикулируют слова, на лице отражается искрення... Video

Певец начинает петь первую строку, его губы четко артикулируют слова, на лице отражается искренняя радость встречи с морем. Он плавно разводит руки в стороны, словно обнимая горизонт. Камера медленно совершает полукруг вокруг него, открывая панораму бескрайнего моря. Чайки пролетают в динамичном...

Камера медленно и плавно скользит вперед над самой поверхностью воды, создавая эффект полета. Мал... Video

Камера медленно и плавно скользит вперед над самой поверхностью воды, создавая эффект полета. Маленькие волны тихо плещутся о берег, создавая едва заметную пену. Вдалеке начинают кружить первые чайки, их темные силуэты четко выделяются на фоне светлеющего неба. Движение камеры величественное и...

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required 88 / 4096

Video-generation prompt with ordered image references: @Image1 identifies the first entry in reference_image_urls, @Image2 the second, and so on.

•required reference_image_urls
Drop a file, or · up to 7

Reference image URLs supplying style and content guidance for the video. Provide between one and 7 images, and refer to them in the prompt using @Image1, @Image2, and so on.

resolution default 480p

Output video's resolution.

aspect_ratio default 16:9

Aspect ratio for the resulting video.

default 8

Video length measured in seconds.

Advanced enable_safety_checker
POST /run/xai/grok-imagine-video/reference-to-video?wait=20 quote → $0.402
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/xai/grok-imagine-video/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Grok Imagine Reference to Video

Builds a clip from a text prompt plus 1 to 7 reference images in `reference_image_urls`, which act as style and content guides. Mention them in the prompt as @Image1, @Image2 and so on, in order. Duration ranges from 1 to 10 seconds (default 8), resolution is 480p or 720p, and several aspect ratios from 16:9 to 9:16 are available.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 4,096 characters
Video-generation prompt with ordered image references: @Image1 identifies the first entry in reference_image_urls, @Image2 the second, and so on.
reference_image_urlsrequired images
Typeurl[] · image
≤ 7 items
Reference image URLs supplying style and content guidance for the video. Provide between one and 7 images, and refer to them in the prompt using @Image1, @Image2, and so on.
durationoptional
Typeinteger
Default8
1 – 10
Video length measured in seconds.
resolutionoptional
Typeenum
Default480p
480p720p
Output video's resolution.
aspect_ratiooptional
Typeenum
Default16:9
16:94:33:21:12:33:49:16
Aspect ratio for the resulting video.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-imagine-video/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 402,
    "usd": "0.402",
    "charged": 402,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video produced by the model.

More models: Reference to Video

For AI agents: this page as Markdown is at https://doitong.com/developers/models/xai/grok-imagine-video/reference-to-video.md. All models and guides: https://doitong.com/developers/llms.txt