Grok Imagine Image Quality Edit API

xai/grok-imagine-image-quality/edit
1K / 2K · 5 种比例

Grok Imagine Image Quality Edit 结合参考素材与自然语言指令完成高保真图像编辑,支持 1–3 张参考图特征融合、风格重塑与细节重绘,提供 1K 与 2K 高清输出。它能够在执行复杂的背景替换、服装变更或元素微调时,深度保留源图片的核心主体身份、面部结构与原片光影色调,实现自然无瑕的视觉合成。

获取 API Key
输入
806
1/3
Reference image 1: Reference 1
输出已就绪
1 × 11 + 1 × 2 = 13 积分 · $0.065

继续使用

示例

edit-01.png

Edit this photograph into blue hour immediately after rain. Preserve the exact elderly man's identity, face, glasses, hair, expression, seated pose, hands, burgundy cardigan, cream shirt, trousers, black accordion and all its keys, chair, rosemary pot, sandstone wall, camera position and framing. Change only the time-of-day lighting and weather effects: cool soft blue evening ambient light, a subtle residual warm glow from beyond the left edge, darker damp paving with small shallow puddles and restrained physically believable reflections, a few moisture beads on the pot. Keep the man and instrument dry and sharply detailed. No falling rain, no new light fixtures, no new or removed objects, people or writing. No advertisement, brand, logo, fox, product display, promotional graphics, or watermark.

edit-02.jpg

Transform the supplied tortoise photograph into a refined hand-painted watercolor natural-history illustration on subtly textured warm white paper. Preserve exactly the same tortoise, its yellow-and-brown shell scute pattern, head direction, limb positions, body proportions, placement on the stone step, moss and the single fern. Keep the original square composition and viewing angle. Replace photographic surfaces with transparent layered watercolor washes and delicate precise graphite-like outlines; retain recognizable anatomy and shell detail, with soft pigment blooms in the moss and background. No labels, borders, captions, new plants, extra animals or writing. No advertisement, brand, logo, fox, product display, promotional graphics, or watermark.

edit-03.jpg

Replace only the old brown wooden door inside the existing arched stone doorway with a well-fitted deep forest-green painted wooden door. The new door must follow exactly the existing arched opening, with simple vertical timber boards, realistic matte painted grain, and one small dark iron handle on the right. Preserve every other part of the photograph: arched stone surround, stone wall pattern, square window, slate roof, coastal grass, sea, sky, perspective, framing, exposure and overcast light. No new steps, decorations, windows, objects, people or text. Make the result look like the same photograph with just the door restored. No advertisement, brand, logo, fox, product display, promotional graphics, or watermark.

Grok Imagine Image Quality Edit 概览

Grok Imagine Image Quality Edit 是 xAI 针对图像局部精修与多素材融合打造的高保真编辑模型。它支持传入 1–3 张参考图片与自然语言修改指令,具备多图特征合成、材质替换、光影风格微调与 Smart Resize 画幅重绘能力,提供 1K 与 2K 两种分辨率输出及 5 种常用构图画幅。

为什么选择 Grok Imagine Image Quality Edit?

  • 1–3 张参考图智能融合支持传入多达 3 张参考图片,模型可智能识别并解耦不同素材中的主体面容、服装与环境元素,告别繁重的手动抠图拼接。

  • 自然语言精准局部重塑仅凭清晰文本指令即可指定特定区域或物品进行修改替换,精准重绘目标元素,完整保留其余画面细节。

  • 主体身份与光影色调锚定无论执行背景更换还是材质重构,深度锚定主体的面部特征、光影角度与色彩基调,确保人物和物料连贯统一。

  • 1K 与 2K 分辨率及多画幅适配原生支持 1K 与 2K 分辨率档位,配合 1:1、2:3、3:2、9:16 和 16:9 比例,满足从社媒头像到高清大图的多样化需求。

  • 透明阶梯计费与退还保障采用清晰的“分辨率基础单价 + 参考图附加费(2 积分/张)”计费体系,若任务因不可抗力失败,自动全额返还全部扣除积分。

参数

参数要求说明
prompt必填

必填非空字符串;上游未声明长度上限。

image_urls必填

1–3 个公开 HTTP(S) 图片 URL,不允许内嵌账号密码。

aspect_ratio可选

支持 1:1、2:3、3:2、9:16、16:9,默认 1:1。

默认1:12:33:29:1616:9
resolution可选

选择 1K 或 2K,默认 1K。

默认1K2K
n可选

输出图片数量,整数且至少为 1,默认 1;上游未声明最大值。

默认1

使用教程

  1. 准备参考图片 URL准备 1–3 张可通过公开 HTTP(S) 访问的清晰源图或参考图 URL(支持单张商品、人物人像或环境样片)。

  2. 编写精准修改指令在提示词中指明要保留的核心主体与要执行的修改变化(如“将图 1 中的人物置于图 2 的暖光木质咖啡馆背景中”)。

  3. 设定输出规格与画幅选择目标分辨率(1K 或 2K)以及目标画面比例(1:1、2:3、3:2、9:16 或 16:9),并设置生成张数 n。

  4. 提交异步编辑任务发起请求提交参数并获取唯一 task_id,后台图像编辑引擎将异步提取多图特征并执行扩散重绘。

  5. 轮询获取成品图片轮询任务状态接口至 finished 状态,读取生成的高保真修改后图像下载链接。

价格

总积分 = 输出数量 × 分辨率单价 + 参考图数量 × 2。参考图费用仅用于编辑,每次请求计一次,不乘输出数量。1 积分 = $0.005。

用量费率详情
1K 输出8 积分 / 输出图片$0.040 / image · Official $0.050 · 20%
2K 输出11 积分 / 输出图片$0.055 / image · Official $0.070 · 21%
参考图(附加费)2 积分 / 参考图片$0.010 / image · Official $0.010

最佳应用场景

  • 电商商品换景与模特换装上传产品图与模特图,无缝将商品替换至多样化真实场景或为虚拟模特更换服饰,显著降低商业实拍成本。

  • 角色面容与品牌资产多图融合结合多张参考图提取稳定人脸特征或品牌视觉元素,在全新构图与光影中维持高度统一的视觉形象。

  • 摄影作品光影与季节氛围重塑对现有摄影作品进行风格迁移,如将日间场景转换为黄昏逆光或将晴天改为雨夜霓虹,保持主体细节真实自然。

  • 社交媒体画幅重构与智能扩展调整原图比例至 9:16 或 16:9,智能推断并补全周边环境与透视景深,适配全渠道内容分发。

专家技巧

  • 传入多张参考图时,在提示词中建议通过序号或明确特征指代不同图片(如“保留第一张图的人物面容与发型,替换为第二张图中的黑色机车皮衣”)。
  • 进行局部编辑时,明确标界“改变”与“保持不变”(例如“仅将手持物品改为纸质咖啡杯,保持人物手势、面部表情与背景完全不变”)。
  • 避免在同一张图片上进行过多轮接续编辑以防画质模糊累积;优先基于高清晰度源图单次完成多要素指令。
  • 结合光学参数描述(如“maintain exact lighting, proportions, and 50mm lens depth of field”)能够帮助模型更自然地使新增元素融入原生环境。

注意事项

  • image_urls 为必填参数,必须包含 1 至 3 个有效且可公开访问的 HTTP(S) 图像 URL。
  • 提示词 prompt 为必填非空字符串,清晰描述修改意图与保留要求;单次请求费用为输出分辨率费用叠加参考图附加费(每张 2 积分)。
  • 任务执行采用异步处理机制,提交后返回 task_id,可通过轮询状态或设置 callback_url 回调接收最终结果。

相关模型推荐

Grok Imagine Image Quality Edit API 常见问题

Grok Imagine Image Quality Edit API 是什么?

Grok Imagine Image Quality Edit 是 xAI 研发的高保真图像编辑模型。它结合 1–3 张参考图片与自然语言指令生成最高 2K 分辨率的高保真修改图像,具备多图智能融合、风格重塑、局部精准替换与 5 种画幅比例适配能力。基于多模态高保真深度生成架构,它在严格遵循文本编辑指令的同时,高度保留源图片的核心主体身份、面部结构与原片光影色调。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Grok Imagine Image Quality Edit 支持传入多少张参考图?

Grok Imagine Image Quality Edit 支持在 image_urls 数组中传入 1 至 3 张公开图片 URL。所有图片必须可通过标准 HTTP(S) 访问且不含身份凭证,平台支持 JPEG、PNG 和 WebP 格式,建议每张图片分辨率清晰且主体无遮挡。

如何避免 Grok Imagine Image Quality Edit 在多次修改后画面变模糊?

避免对同一张图片进行长链式连续再编辑是保持画质的关键。建议优先使用高分辨率原始图片,并在提示词中明确加入“maintain exact lighting, proportions, and color palette”等保持指令,将换装、换景或元素调整合并在单次请求中完成。

如何在 Grok Imagine Image Quality Edit 中精准控制修改范围?

建议在提示词中同时明确“修改目标”与“保留区域”。例如明确指出“仅将背景替换为明亮现代办公室,保持主体人物发型、容貌及灰色西装质感完全不变”,帮助扩散模型精准锁定需重绘的像素范围。

Grok Imagine Image Quality Edit 的参考图附加费是如何计算的?

Edit 端点总费用由输出图片费用与参考图附加费组成。参考图附加费为每张参考图 2 积分($0.010),单次请求统一核算一次,不随输出图片张数 n 翻倍扣除;生成的输出图片则根据 1K(8 积分)或 2K(11 积分)单价乘以 n 计算。

Grok Imagine Image Quality Edit 后续会迁移至哪个版本?

根据 xAI 官方技术规划,Grok Imagine Image Quality 计划于 2026 年 11 月 2 日完成服务过渡,推荐后续业务流程迁移至新一代 Grok Imagine Image 2.0 Edit。新版本在多图融图一致性、局部修图精度与细节保留方面表现更为出色。

Grok Imagine Image Quality Edit 编辑生成的图片可以商用吗?

可以。根据 xAI 服务条款,调用该模型生成的编辑成果物所有权归用户所有,可合法用于商业广告、电商展示、产品包装及各类宣发物料。使用者需确保所上传参考图具备合法合规授权,并遵守平台使用政策与版权法规。