Grok Imagine Reference to Video
整合
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/zh-TW/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"
]
}
}
透過 Doitong API 呼叫 Grok Imagine Reference to Video 模型(xai/grok-imagine-video/reference-to-video)。代理程式文件:https://doitong.com/zh-TW/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"
]
}
如果回應狀態為 "queued" 或 "running",請輪詢 GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20,直到狀態變為 "succeeded";檔案位於 outputs[].url。使用相同主體傳送 POST https://api.doitong.com/v1/quote/xai/grok-imagine-video/reference-to-video,可在執行前取得確切價格。
像範例一樣的檔案: $0.402 402 API 點數 您的檔案會在執行前計量 在此頁面執行
您的新 API 金鑰。 僅會在此時顯示,且已填入下方的程式碼與 API 金鑰欄位。請妥善保密:切勿將其放入在瀏覽器中執行的程式碼。
在 Doitong 上製作
Doitong 社群使用 Grok Imagine 製作的公開作品。一鍵重複使用提示詞。
影片
Саи шевелит губками, как будто шепчет вопрос, глазки полны надежды и страха, мама не реагирует сразу. Камера медленно зумит на лицо Саи, свет теплеет, лёгкий ветерок шевелит штору. Эмоциональный бит уязвимого вопроса, трогательный пик, 3D Pixar, вертикальный. On-screen dialogue (characters speak...
影片
Мама внезапно поворачивается, глаза открыты с любовью, резко прижимает Саи к груди сильно, Саи расслабляется в объятиях. Камера быстро долли ин из среднего к close-up объятия, свет разливается теплее, одеяло слегка морщится. Эмоциональный бит взрывной нежности и облегчения, Pixar 3D динамика,...
影片
Мама держит Саи крепко, качая слегка, Саи чувствует тепло, их дыхание синхронизируется. Камера медленно орбитирует вокруг объятия по кругу, свет угасает к уютному сумраку, лёгкие блики на лицах. Эмоциональный бит глубокого принятия и любви несмотря на тоску, cathartic resolution, стиль Pixar 3D,...
影片
Саи лежит тихо, её глазки расширяются в раздумье, мама остаётся с закрытыми глазами, лёгкий вздох. Камера медленно поднимается вверх от кровати, фокус на Саи, свет мерцает subtly. Эмоциональный бит формирования запретной мысли, напряжённый шёпот, Pixar стиль, 9:16. On-screen dialogue (characters...
影片
Алиса медленно и очень забавно поворачивает голову сначала влево, затем вправо, пытаясь осознать причину шума. Камера совершает круговое вращение вокруг ее головы на 90 градусов. Ее маленькая пухлая ручка тянется к объективу, пальцы медленно сжимаются и разжимаются. Атмосфера сцены передает милое...
影片
Лицо матери неподвижно, она смотрит на кормящегося малыша с усталостью и огромной любовью, слеза медленно скатывается по щеке, не от грусти, а от глубины эмоций. Камера статична в крупном плане, лёгкое дыхание колышет воздух, свет ночника слегка пульсирует. Строится ощущение тихой силы и...
影片
Марина медленно и неохотно протягивает руку из-под одеяла, нащупывая звенящий будильник. Её пальцы забавно перебирают по поверхности тумбочки, пока она наконец не выключает его резким нажатием. Камера плавно наезжает на её лицо, когда она открывает один глаз с выражением глубокой усталости. В...
影片
Мама плавно опускается на деревянный стул, издавая тяжелый, но облегченный вздох. Она берет металлическую вилку и медленно подносит её к тарелке, предвкушая первый кусочек. Камера плавно наезжает на её лицо, фиксируя мимолетную улыбку. В воздухе в лучах солнца медленно кружатся пылинки. Движение...
影片
Мирра медленно наклоняет голову в сторону, не отрывая взгляда от камеры, её губы трогает едва заметная, дерзкая ухмылка. Камера плавно наезжает на её лицо, усиливая напряжение. Дым от благовоний на заднем плане лениво закручивается в спирали. Эмоциональный посыл — полное превосходство и знание...
影片
Сая делает глубокий, спокойный вдох во сне и её губы растягиваются в счастливой улыбке. Камера начинает медленное и величественное движение вертикально вверх, уходя к потолку, пока вся сцена плавно не растворяется в мягком белом свете. В окне на заднем плане видны медленно проплывающие ночные...
影片
Камера очень медленно и плавно наезжает на героев, одиноко сидящих на футуристической скамейке. Пальцы мягко перебирают клавиши старой гармошки, вокруг них в воздухе красиво кружатся золотистые осенние листья, подхваченные легким теплым ветром. Агрессивный шум мегаполиса на заднем фоне словно...
影片
Марина быстро и бездумно проводит товары над сканером, который издает монотонные звуки. Её взгляд направлен в никуда, губы плотно сжаты. Камера медленно движется вправо вдоль кассовой ленты, создавая ощущение бесконечного конвейера. Окружающий шум магазина сливается в гул, подчеркивая её...
影片
Сая медленно моргает и слегка поворачивает голову в сторону, словно прислушиваясь к далекому звуку. Камера медленно отдаляется от её лица, открывая больше пространства комнаты. В воздухе чувствуется легкое движение тени от проезжающей за окном машины. Переход от личного, уютного момента к более...
影片
Мама плавно закрывает глаза, плечи опускаются от тяжести, Саи моргает медленно. Камера долли ин к лицу мамы, свет слегка тускнеет, шторы неподвижны. Эмоциональный бит ощущения материнской тяжести, трогательный и тихий, стиль Pixar 3D, вертикальный. On-screen dialogue (characters speak with...
影片
Отец медленно и ритмично покачивается в кресле, его голова слегка наклонена к ребенку, а на лице играет едва заметная, счастливая улыбка. Младенец делает глубокий вдох, едва заметно шевеля пальчиками. Камера плавно и медленно наезжает на лица героев, подчеркивая интимность момента. Легкая...
影片
Крупный план Саи, её глаза наполняются теплом и любовью, лёгкая улыбка появляется, взгляд устремлён вверх к маме. Камера очень медленно зумит на глаза, затем слегка трясётся как сердцебиение. Свет ночника отражается в зрачках, создавая искры, передавая абсолютную детскую преданность. голос саи...
建立請求
控制項是根據模型結構描述生成的。變更設定時,程式碼和價格會同步更新。
/run/xai/grok-imagine-video/reference-to-video?wait=20
報價 → $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
}
}
}
關於 Grok Imagine Reference to Video
根據文字提示詞和 `reference_image_urls` 中的 1 到 7 張參考影像建立片段,這些影像作為風格和內容指引。依序在提示詞中以 @Image1、@Image2 等方式提及。長度為 1 到 10 秒(預設 8),解析度為 480p 或 720p,並提供從 16:9 到 9:16 的多種長寬比。
參數
請傳送標準名稱或原生名稱其中之一,不要同時傳送兩者。 標準名稱
prompt必填
reference_image_urls必填
images
duration選填
resolution選填
aspect_ratio選填
enable_safety_checker選填
檔案參數接受公開的 https:// URL、最大 10 MB 的 data: URI,或上傳檔案的 file_url。 檔案
輸出
{
"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"
}
}
輸出欄位
- video
- object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}模型產生的影片。
其他 Grok Imagine 變體
更多模型:參考圖轉影片
給 AI 代理程式:此頁面的 Markdown 位於 https://doitong.com/zh-TW/developers/models/xai/grok-imagine-video/reference-to-video.md. 所有模型與指南: https://doitong.com/developers/llms.txt