Grok Imagine Image · Edit
集成
xai/grok-imagine-image/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/edit?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.ru/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.ru/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/edit?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.ru/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/edit", 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/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "xai/grok-imagine-image/edit",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}
通过 Doitong API 调用 Grok Imagine Image · Edit 模型(xai/grok-imagine-image/edit)。智能体文档:https://doitong.com/zh/developers/models/xai/grok-imagine-image/edit.md
POST https://api.doitong.ru/v1/run/xai/grok-imagine-image/edit?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.ru/v1/requests/REQUEST_ID?wait=20,直到状态变为 "succeeded";文件位于 outputs[].url。使用相同请求体 POST https://api.doitong.ru/v1/quote/xai/grok-imagine-image/edit,可在运行前返回确切价格。
此请求: $0.022 22 API 积分 · ≈ ₽2.37 在此页面运行
你的新 API 密钥。 它仅在此时显示,并且已填入下方的代码和 API 密钥字段中。请妥善保密:切勿将其放入在浏览器中运行的代码。
在 Doitong 上制作
Doitong 社区使用 Grok Imagine Image 制作的公开作品。一键复用提示词。
Brand guidelines: Visual style: Cinematic Realistic: photorealistic live-action, shallow depth of field, dramatic lighting, film grain. Reference images context (match the visual style and elements from these): - reference photo (style_reference): use as visual reference for setting, objects, and...
Art style: Cinematic Realistic. Full-length view, the entire figure visible from head to feet, standing upright, a 24-year-old man centered in frame. He is a fictional everyman: slim, slightly under-built frame with noticeably slouched, rounded shoulders and a caved-in posture that reads as...
Art style: мультяшный. An extreme wide high-angle composition looking down at the sunlit yellow kitchen table. Lily peers over the edge into her open turquoise lunchbox where Broc and Apple Slice sit side-by-side holding miniature bright red paper hearts aloft. Lily's expression transforms into...
Art style: Clay / Plasticine. ПОЖИЛАЯ АНЯ. Clay plasticine figure of an elderly woman with dark hair streaked with sculpted silver strands in a low bun. Her face is kind and lined, with visible clay texture. She wears a mustard-yellow knitted scarf over a dark-green cardigan. Silhouette tag:...
Art style: Clay / Plasticine. ЭЛЛИПСИС, другая локация. Гостиная с серыми незакрашенными стенами освещена окном и голой лампой. Миша в тёмно-синей толстовке и Аня в горчичном свитере стоят у стены, у каждого кисть в правой руке. На полу ровно два ведра коралловой краски.. изменить одежду на...
A traditional hand-drawn FILM STORYBOARD SHEET for scene 2: one page divided into a clean 3x3 grid of NINE separate rectangular panels, three rows of three, each panel a 9:16 rectangle with a thin ruled black border and a small hand-written panel number in its top-left corner from 1 to 9. Thin...
A traditional hand-drawn FILM STORYBOARD SHEET for scene 3: one page divided into a clean 3x3 grid of NINE separate rectangular panels, three rows of three, each panel a 9:16 rectangle with a thin ruled black border and a small hand-written panel number in its top-left corner from 1 to 9. Thin...
A traditional hand-drawn FILM STORYBOARD SHEET for scene 1: one page divided into a clean 3x3 grid of NINE separate rectangular panels, three rows of three, each panel a 9:16 rectangle with a thin ruled black border and a small hand-written panel number in its top-left corner from 1 to 9. Thin...
Art style: 3D Stylized Animation. Elara. Молодая женщина около 27 лет с выразительными карими глазами, аккуратным сияющим макияжем и теплыми каштановыми волосами, собранными в стильный свободный хвост. Атлетичное грациозное телосложение, открытая лучезарная улыбка. Одета в приталенный деловой...
Art style: Cinematic Realistic. Small kitchen, cold diffused window light. Anna in oatmeal cardigan stands at the table holding an unfolded medical sheet in both hands; a closed white door behind her. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative...
Art style: Cinematic Realistic. Street outside an apartment entrance, overcast drizzle, wet asphalt. Exactly one dark grey hatchback at the curb, trunk open; Oleg in navy jacket holds a black duffel bag; Anna in oatmeal cardigan stands at the porch steps, left hand clutching her collar....
Art style: Cinematic Realistic. Kitchen doorway, same cold window light. Anna in oatmeal cardigan mid-step toward the door frame; worn brown plush teddy bear visible low at the right frame edge. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering...
Art style: Cinematic Realistic. Same street, drizzle. Oleg in navy jacket stands at the open trunk, right hand on its lid; Anna in oatmeal cardigan at his left, holding her collar. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it...
Art style: Cinematic Realistic. Same street, drizzle. Exactly one dark grey hatchback at the curb, driver door closed, Oleg inside at the wheel; Anna in oatmeal cardigan on the sidewalk beside a large puddle. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the...
Art style: Cinematic Realistic. Same landing, warm lamp. Irina Petrovna in burgundy cardigan in the chained door gap, eyes aside; Anna in oatmeal cardigan facing her. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any...
Art style: Cinematic Realistic. Apartment landing, warm ceiling lamp. Anna in oatmeal cardigan in medium at the door; door open a hand's width on a brass chain, Irina Petrovna in burgundy cardigan in the gap. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the...
构建请求
控件根据模型架构生成。更改控件时,代码和价格会同步更新。
/run/xai/grok-imagine-image/edit?wait=20
报价 → $0.022
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/edit?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.ru/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.ru/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/edit?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.ru/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/edit", 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/edit",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}
关于 Grok Imagine Image · Edit
根据最多 8000 个字符的提示词编辑图像,在 `image_urls` 中使用最多 3 个 URL。`aspect_ratio` 默认为 auto,会保留第一张输入图像的比例,也可显式设置。分辨率为 1k 或 2k,最多输出 4 张 jpeg、png 或 webp 图像。响应会返回修订后的提示词。
参数
发送规范名称或原生名称之一,不要同时发送两者。 规范名称
prompt必填
num_images可选
num_outputs
aspect_ratio可选
resolution可选
output_format可选
enable_safety_checker可选
image_urls可选
images
文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件
输出
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "xai/grok-imagine-image/edit",
"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": 22,
"usd": "0.022",
"charged": 22,
"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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
"cancel": "https://api.doitong.ru/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 变体
更多模型:图像编辑
对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/xai/grok-imagine-image/edit.md. 所有模型和指南: https://doitong.com/developers/llms.txt






