文本转图像加上多重引用编辑，支持最多五张源图像，自动或钉顶质量等级，以及1K或2K输出分辨率。
xAI图像生成发布日期 2026年8月7日专有端点新文本转图像加上多重引用编辑，支持最多五张源图像，自动或钉顶质量等级，以及1K或2K输出分辨率。
也称为 Grok Imagine Image, xAI Grok Imagine Image 2.0
grok-imagine-image-2-0/v1/images/generationsPOST/v1/images/editsgrok-imagine-image-2grok-imagine-image-2.0xai/grok-imagine-image-2-0xai/grok-imagine-image-2xai/grok-imagine-image-2.0来自 EmpirioLabs 目录的实时按量计费价格。只为实际用量付费，没有月度最低消费。
Grok Imagine Image 2.0 通过 POST /v1/images/generations 运行。请求会立即返回 job_id；轮询 GET /v1/jobs/{job_id} 直到任务完成，再从结果中读取输出 URL。 也可以加上 "sync": true 跳过轮询：请求保持打开并直接返回 OpenAI 风格的完整图像响应，OpenAI SDK 可以原样使用。 在EmpirioLabs 控制台获取 API 密钥。
curl https://api.empiriolabs.ai/v1/images/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-2-0",
"prompt": "Describe what you want Grok Imagine Image 2.0 to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/images/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "grok-imagine-image-2-0",
"prompt": "Describe what you want Grok Imagine Image 2.0 to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs 上 Grok Imagine Image 2.0 API 支持的请求参数。省略字段时使用默认值。
| 参数 | 类型 | 默认值 | 范围 / 值 | 描述 |
|---|---|---|---|---|
| prompt | string | - | - | 描述要创作的图像。附上源图像后，这就是编辑指令。将多张图像称为 <IMAGE_0>、 <IMAGE_1>、 ，依此类推。最多可达8,000字符。 |
| image | array | - | - | 一到五张源图片进行编辑，作为URL、数据URI或上传的图片对象。保持空格，仅凭提示生成。 |
| images | array | - | - | 多个上传图片参考的复数别名。 |
| quality | enum | auto | auto, low, medium | 渲染质量。自动让模型为每个请求选择等级，计费则跟随它所服务的等级。低回报只需几秒钟，且每张图片成本更低。中等分辨率耗时更长，细节更细致。 |
| resolution | enum | 1k | 1k, 2k | 输出分辨率层。2k渲染的像素更多，每张图片的成本也比1k高。 |
| aspect_ratio | enum | auto | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 21:9, 5:... | 输出宽高比。自动让模型选择最适合提示的画面。编辑时，自动会跟随第一个源图像。包括21：9和5：2宽屏及横幅格式。 |
| num_images | number | 1 | 1 到 10 | 输出图像的数量。每张输出图像都单独计费。 |
| response_format | enum | url | url, b64_json | 默认返回签名图像URL，或在请求时包含base64图像数据b64_json。 |
可根据文本提示生成图片，或通过自然语言指令编辑最多五张源图片。模式- 文本对图像：发送无图像的提示。- 图像编辑：附加一张图片并描述你想要的更改。- 多图编辑：附加两到五张图片以组合主题、转移风格或合成场景。在提示中称呼它们为 <IMAGE_0>、 <IMAGE_1>、 等。示例多图提示 “ Place the product from <IMAGE_0> onto the marble surface in <IMAGE_1>. ”' 默认 - 1K分辨率自动质量 - 自动宽高比，模型选择最合适的提示 - 每个请求输出一张图片 质量和分辨率 质量决定渲染所需的工作量。自动让模型为每个请求选择层级，目前文本提示为低层级，编辑为中等。低级几秒钟后返回。中等分辨率耗时更长，细节更细致。分辨率选择1K或2K输出层级。质量和分辨率合并为四个价格区间，因此低1K图像是最便宜的选择，中等2K图像则最为精细。控件 支持提示、源图片（URL或上传）、质量、分辨率、宽高比，涵盖16种比例，包括自动和21：9和5：2宽屏格式，图片数量和响应格式。限制 - 每次编辑最多5张源图片 - 每个请求最多10张输出图片 - 提示字数最多8000字符计费计费 - 按所提供的质量和分辨率按输出图像收费，外加每张图片的每张图片费用。文本到图片不收取源图费用。- 自动质量的费用根据该请求所提供的型号等级划分。当你希望提前确定价格时，将质量设置为低或中。- 在生成任何图片前验证失败或被拒绝的请求不计费。- 生成后被内容策略阻挡的图片仍会计费。这遵循 xAI 使用策略，即使输出被内容安全检查阻挡，生成过程仍需计费。将提示和来源图片纳入使用策略内以避免此类情况。内容安全** 生成的图片通过自动内容安全检查。标记为显式的图像不会返回。由于图像是在检查运行前生成的，标记生成仍会计费。
在 EmpirioLabs，Grok Imagine Image 2.0 按量计费：低质量，1K $0.048 每张图片; 低质量，2K $0.072 每张图片; 中等质量，1000 $0.072 每张图片; 中等质量，2K $0.096 每张图片; 图像输入 $0.05 每张图片。本页的实时价格表始终与 API 的实际计费一致。
Grok Imagine Image 2.0 通过 api.empiriolabs.ai 上的 POST /v1/images/generations 提供，使用标准的 Bearer 令牌认证。
可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 Grok Imagine Image 2.0，你可以在写代码之前先测试提示词。
创建 EmpirioLabs 账户，然后在控制台的 API Keys生成密钥。计费使用按量付费的额度，只为实际发出的请求付费。
