Grok Imagine Reference to Video
Integrate
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"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/xai/grok-imagine-video/reference-to-video?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"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"
]
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"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",
],
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/xai/grok-imagine-video/reference-to-video", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "xai/grok-imagine-video/reference-to-video",
"input": {
"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"
]
}
}
Call the Grok Imagine Reference to Video model (xai/grok-imagine-video/reference-to-video) through the Doitong API. Docs for agents: https://doitong.com/developers/models/xai/grok-imagine-video/reference-to-video.md
POST https://api.doitong.com/v1/run/xai/grok-imagine-video/reference-to-video?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"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"
]
}
If the response status is "queued" or "running", poll GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 until it is "succeeded"; the files are in outputs[].url. POST https://api.doitong.com/v1/quote/xai/grok-imagine-video/reference-to-video with the same body returns the exact price before the run.
Files like the example: $0.402 402 API credits your files are measured before the run Run it on this page
Your new API key. It is shown only now and is already in the code and in the API key field below. Keep it secret: never put it in code that runs in a browser.
Made on Doitong
Public works made with Grok Imagine by the Doitong community. Reuse a prompt in one click.
Video
Струя воды из шланга неожиданно окатывает Анну с головы до ног. Она вздрагивает, зажмуривается и пытается прикрыться руками, при этом комично роняя тяпку. Камера быстро зумирует на её промокшее лицо, фиксируя забавную гримасу. На заднем плане слышен приглушенный смех детей. Момент внезапности и...
Video
Дети одновременно прыгают в бассейн, создавая огромный столб брызг, который летит прямо в сторону камеры. Камера имитирует эффект замедленной съемки в момент полета, а затем резко ускоряется при ударе о воду. Вода разлетается мириадами сверкающих капель. Динамика кадра подчеркивает энергию и хаос...
Video
Буня смешно подпрыгивает, пытаясь поймать бабочку зубами, его уши забавно хлопают на ветру. Камера движется параллельно собаке, создавая эффект слежения. Трава и цветы мелькают на переднем плане. Бабочка ловко уворачивается, заставляя песика крутиться на месте. Эмоция — чистая радость и игривость...
Video
Анна медленно опускается в шезлонг, выдыхая с облегчением, и открывает книгу. Камера плавно наезжает на её лицо, запечатлевая момент долгожданного покоя. На заднем плане внезапно пролетает яркий мяч, нарушая идиллию. Ветер слегка колышет ветви деревьев, создавая игру теней на траве. Эмоция...
Video
Камера стремительно отлетает назад и вверх, превращая сцену в грандиозную панораму. Певец продолжает петь припев, его голос словно сливается с шумом волн. Вода внизу движется хаотично и мощно, разбиваясь о непоколебимые скалы. Облака в небе быстро движутся, создавая игру света и тени на...
Video
Певец поет с нарастающей страстью, его мимика передает каждое слово песни. Он медленно закрывает глаза на мгновение, а затем открывает их, наполненных светом. Камера плавно приближается к его лицу, фокусируясь на эмоциях. В фоне заметно легкое движение облаков и мерцание моря, создающее ощущение...
Video
Певец начинает петь первую строку, его губы четко артикулируют слова, на лице отражается искренняя радость встречи с морем. Он плавно разводит руки в стороны, словно обнимая горизонт. Камера медленно совершает полукруг вокруг него, открывая панораму бескрайнего моря. Чайки пролетают в динамичном...
Video
Камера медленно и плавно скользит вперед над самой поверхностью воды, создавая эффект полета. Маленькие волны тихо плещутся о берег, создавая едва заметную пену. Вдалеке начинают кружить первые чайки, их темные силуэты четко выделяются на фоне светлеющего неба. Движение камеры величественное и...
Video
Art style: Pixar-like 3D. 🎬 STAGING CONTRACT WORLD LOCK: большой кожаный диван (large leather sofa), стеклянный столик (glass table). Vladimir_Senior and children are on the sofa (screen-center, midground). AXIS LOCK: Line from camera to sofa. Camera remains straight-on. Vladimir fixed...
Video
Art style: 3D stylized animation. Статичная камера. Мужчины синхронно шагают по красной дорожке.плавный зум на их лица. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any style wording elsewhere in the prompt): Render...
Video
Art style: Pixar-like 3D. 🎬 STAGING CONTRACT WORLD LOCK: раскидистый дуб (spreading oak), кирпичная дорожка (brick path). Vladimir_Adult and children are on the path (screen-center, midground). AXIS LOCK: Line of the path. Camera remains straight-on. Family stays fixed screen-center. SHOT LIST:...
Video
Art style: 3D Pixar animation. Статичная камера. Герой в отчаянии треплет волосы, с ужасом глядя на убыточные показатели. SPOKEN LINE — AUTHORITATIVE, overrides any line quoted earlier in this prompt: The only words spoken, in Russian, verbatim: Парень: "Но сколько пройдет времени, пока я не...
The camera starts with a close-up on the Uterus's face showing pure exhaustion, then slowly tilts down to reveal the tiny, injured Sperm hobbling into the frame. The Sperm stops and tries to puff out its chest heroically while waving a crutch in the air. As he speaks, he loses his balance and...
Video
Art style: Pixar-like 3D. Maak een video van precies 30 seconden waarin Niels Alexandra verwelkomt in de Alexanderhoeve-winkel. **ABSOLUUT BELANGRIJK — DE WINKELLOCATIE:** Gebruik de door mij geüploade foto van onze echte Alexanderhoeve-winkel als verplichte visuele referentie voor de volledige...
Video
Art style: 3D stylized animation. Дверь автомобиля медленно открывается вверх. Мужчина выходит из автомобиля под дождь и уверенным жестом поправляет пиджак. Легкий ветер шевелит его волосы. Капли дождя интенсивно падают, разбиваясь о гладкий кузов машины. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━...
Video
Art style: 3D stylized animation. Статичная камера. Мужчина слегка поворачивает голову и мягко ухмыляется, демонстрируя полное превосходство и спокойствие. SPOKEN LINE — AUTHORITATIVE, overrides any line quoted earlier in this prompt: The only words spoken, in Russian, verbatim: Лео: "Одна из...
Build a request
Controls are generated from the model schema. The code and the price update as you change them.
/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"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/xai/grok-imagine-video/reference-to-video?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"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"
]
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"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",
],
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/xai/grok-imagine-video/reference-to-video", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "xai/grok-imagine-video/reference-to-video",
"input": {
"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"
]
},
"wait_seconds": 20
}
}
}
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
promptrequired
reference_image_urlsrequired
images
durationoptional
resolutionoptional
aspect_ratiooptional
enable_safety_checkeroptional
File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files
Output
{
"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"
}
}
Fields of output
- video
- object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video produced by the model.
Other Grok Imagine variants
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