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

Саи шевелит губками, как будто шепчет вопрос, глазки полны надежды и страха, мама не реагирует сразу. Камера медленно зумит на лицо Саи, свет теплеет, лёгкий ветерок шевелит штору. Эмоциональный бит уязвимого вопроса, трогательный пик, 3D Pixar, вертикальный. On-screen dialogue (characters speak...

Мама внезапно поворачивается, глаза открыты с любовью, резко прижимает Саи к груди сильно, Саи ра... Video

Мама внезапно поворачивается, глаза открыты с любовью, резко прижимает Саи к груди сильно, Саи расслабляется в объятиях. Камера быстро долли ин из среднего к close-up объятия, свет разливается теплее, одеяло слегка морщится. Эмоциональный бит взрывной нежности и облегчения, Pixar 3D динамика,...

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

Мама держит Саи крепко, качая слегка, Саи чувствует тепло, их дыхание синхронизируется. Камера медленно орбитирует вокруг объятия по кругу, свет угасает к уютному сумраку, лёгкие блики на лицах. Эмоциональный бит глубокого принятия и любви несмотря на тоску, cathartic resolution, стиль Pixar 3D,...

Саи лежит тихо, её глазки расширяются в раздумье, мама остаётся с закрытыми глазами, лёгкий вздох... Video

Саи лежит тихо, её глазки расширяются в раздумье, мама остаётся с закрытыми глазами, лёгкий вздох. Камера медленно поднимается вверх от кровати, фокус на Саи, свет мерцает subtly. Эмоциональный бит формирования запретной мысли, напряжённый шёпот, Pixar стиль, 9:16. On-screen dialogue (characters...

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

Алиса медленно и очень забавно поворачивает голову сначала влево, затем вправо, пытаясь осознать причину шума. Камера совершает круговое вращение вокруг ее головы на 90 градусов. Ее маленькая пухлая ручка тянется к объективу, пальцы медленно сжимаются и разжимаются. Атмосфера сцены передает милое...

Лицо матери неподвижно, она смотрит на кормящегося малыша с усталостью и огромной любовью, слеза ... 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