Grok Imagine Image
یکپارچهسازی
xai/grok-imagine-image
# 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-image?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"
}'
# 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-image?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"
}),
});
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",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/xai/grok-imagine-image", 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/fa/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-image",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}
مدل Grok Imagine Image (xai/grok-imagine-image) را از طریق Doitong API فراخوانی کنید. مستندات عاملها: https://doitong.com/fa/developers/models/xai/grok-imagine-image.md
POST https://api.doitong.com/v1/run/xai/grok-imagine-image?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"
}
اگر وضعیت پاسخ "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-image با همان بدنه، قیمت دقیق را پیش از اجرا برمیگرداند.
این درخواست: $۰٫۰۲ ۲۰ اعتبار API اجرای آن در این صفحه
کلید API جدید شما. این کلید فقط همین حالا نمایش داده میشود و از قبل در کد و فیلد کلید API زیر قرار گرفته است. آن را محرمانه نگه دارید: هرگز آن را در کدی که در مرورگر اجرا میشود قرار ندهید.
ساختهشده در Doitong
آثار عمومی ساختهشده با Grok Imagine Image توسط جامعه Doitong. یک پرامپت را با یک کلیک دوباره استفاده کنید.
Art style: 3D Cartoon. Opa Sigmund. Ein 70-jähriger Mann mit flauschigem weißem Haar, einem gepflegten weißen Bart und einer runden Brille auf einer freundlich faltigen Nase. Er trägt einen kuscheligen braunen Strick-Cardigan über einem weißen Hemd mit dunkler Fliege. Seine Augen sind ein warmes...
Art style: 3D Cartoon. Der Enkel. Ein sechsjähriger Junge mit zerzaustem dunkelbraunem Haar und großen, neugierigen braunen Augen. Er trägt einen groben Wollpullover in Waldgrün. Er sitzt mit verschränkten Beinen auf einem gemusterten Orientteppich und blickt mit offenem Mund und voller...
Art style: 3D Cartoon. Columbus standing in the middle ground. Columbus is standing on deck in the middle ground in the midground. Torso facing camera. Head facing camera. Eyes on horizon. Gripping railing. Determined. Ships sits in the middle ground in the background. Wide shot from a low angle,...
Art style: 3D Cartoon. Sigmund standing in the near foreground; Enkel standing further back in the frame. Sigmund is standing on floor in the near foreground in the midground. Torso in three-quarter turn to screen-right. Head in three-quarter turn to screen-right. Eyes on Globe. On globe. Serene....
Art style: 3D Cartoon. Rodrigo standing in the middle ground. Rodrigo is standing on crow's nest in the middle ground in the foreground. Torso facing camera. Ships sits in the middle ground in the midground. Extreme wide shot from a high angle, 9:16. Horizon high. Opening extreme wide, ending...
Art style: Classic Fairytale. Бао. Round chubby plush panda toy, soft black-and-white fur with visible fabric pile texture, big fat white belly, black ear and limb patches, shiny black button eyes, tiny stitched smile, stubby legs, waddling gait, no clothing and no props. Silhouette tag: widest...
Cinematic head-and-shoulders portrait, face close-up, sharp eyes in crisp focus, shallow depth of field, soft key light with gentle rim light, filmic colour grading. The character looks slightly past the camera with a natural, expressive gaze. Neutral, softly blurred background. No text, no...
Art style: Paper Cut. PUP. Paper-cut style small sandy-brown puppy, fluffy layered paper fur, oversized paws and ears, bright shiny dark eyes, no grey on muzzle, the same frayed red collar with round brass tag but loose and sliding over one shoulder, textured torn paper edges, brighter warmer...
Art style: Cyberpunk sci-fi anime / 3D cinematic, неоновые серверные стойки, палитра глубокого синего и бирюзового неона. Dark orbital command bridge lit by flickering red emergency lamps, bright enough to read. The hooded cyborg sits mid-frame, both silver hands on a black laptop keyboard, with...
Art style: Cyberpunk sci-fi anime / 3D cinematic, неоновые серверные стойки, палитра глубокого синего и бирюзового неона. Bridge from the side: GITFLIC right with right paw raised among the green streams, an old grey server rack with a white cat-head emblem on the left, a large porthole behind...
IMAGE EDIT of the attached reference image — it is the SAME character. Keep the composition, pose, framing, facial identity, art style, kit, background and every other detail EXACTLY as in the reference. Change ONLY this: не должно быть на лице глаз и носа, вместо них на лице потертость.
ساخت درخواست
کنترلها از شِمای مدل تولید میشوند. با تغییر آنها، کد و قیمت بهروزرسانی میشوند.
/run/xai/grok-imagine-image?wait=20
قیمت → $۰٫۰۲
# 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-image?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"
}'
# 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-image?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"
}),
});
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",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/xai/grok-imagine-image", 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-image",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}
اجرای این درخواست
کلید شما در این مرورگر باقی میماند: فقط به Doitong API ارسال میشود و فقط در صورت فعالکردن گزینه «یادآوری»، در localStorage ذخیره میشود. دریافت کلید API
درباره Grok Imagine Image
از پرامپتی حداکثر 8000 نویسهای حداکثر 4 تصویر تولید میکند. `aspect_ratio` شامل 13 گزینه از جمله 16:9، 4:3، 1:1، 9:16 و نسبتهای فوقعریض یا بلند است و `resolution` برابر 1k یا 2k است. خروجی jpeg، png یا webp است. پاسخ همچنین پرامپت بازبینیشدهای را که واقعاً استفاده شده برمیگرداند.
پارامترها
نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نامهای استاندارد
promptالزامی
num_imagesاختیاری
num_outputs
aspect_ratioاختیاری
resolutionاختیاری
output_formatاختیاری
enable_safety_checkerاختیاری
خروجی
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "xai/grok-imagine-image",
"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": 20,
"usd": "0.02",
"charged": 20,
"refunded": 0
},
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"output": {
"images": [
{
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
"content_type": "image/jpeg",
"file_name": "0-output.jpeg",
"file_size": 1843200,
"width": 1024,
"height": 768
}
],
"revised_prompt": "string"
},
"outputs": [
{
"type": "image",
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
"content_type": "image/jpeg",
"file_size": 1843200,
"width": 1024,
"height": 768,
"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"
}
}
فیلدهای خروجی
- images
- array of object {url, content_type, file_name, file_size, width, height}URL تصویر تولیدشده.
- revised_prompt
- string | nullپرامپت بهبودیافته استفادهشده برای تولید تصویر.
گونههای دیگر Grok Imagine Image
مدلهای بیشتر: متن به تصویر
برای عاملهای هوش مصنوعی: این صفحه بهصورت Markdown در دسترس است https://doitong.com/fa/developers/models/xai/grok-imagine-image.md. همه مدلها و راهنماها: https://doitong.com/developers/llms.txt







