Grok Imagine Image 2.0 API

xAI-图像生成Live

$0.030 / 张起（1K Low）-25%$0.040 官方价

文生图图像编辑多参考图合成单次 1-10 张13 种比例1K / 2K 输出

线路状态

Live异步任务追踪

模型亮点

生成与编辑一体，单张 $0.03 起

适用场景

社交素材、广告创意、批量出图、参考图编辑

输入

文本提示词 + 可选 1-3 张输入图

输出

单次 1-10 张图

Playground 定价介绍 API

接入 API 之前，先试用 Grok Imagine Image 2.0。

在正式接入前测试出图质量、估算积分消耗、生成示例。

Create image task

Fixed to grok-imagine-image-2.0

Grok Imagine Image 2.0From $0.030/image - 2.04 cr/image (1K Low)

Prompt

A cinematic, photorealistic late-night workspace in a near-future city.

A developer sits casually at a clean desk beside a large rain-covered window, focused on a laptop. Outside, the city glows softly through the rain with restrained cyan, emerald-green and occasional violet light. The atmosphere feels slightly cyberpunk, but realistic and lived-in rather than futuristic fantasy.

The room is quiet and minimal: dark graphite surfaces, a mechanical keyboard, a half-finished cup of coffee, subtle cable details, soft reflections on glass and brushed metal. Natural posture, realistic hands, authentic skin texture, understated clothing, candid documentary feeling.

The laptop screen shows a clean dark interface with the small word “EvoLink” in the corner, spelled exactly and clearly. No large logo, no slogan, no floating holograms, no obvious network diagrams.

Soft emerald #00FF88 and cyan #00D4FF screen light gently illuminate the developer’s face and hands, with a very subtle violet #7C3AED accent in the distant city. Moody cinematic lighting, realistic rain reflections, shallow depth of field, medium-format editorial photography, premium technology brand aesthetic, sophisticated and understated.

No excessive neon, no crowded cyberpunk signs, no sci-fi armor, no dramatic holograms, no fake interface text, no extra words, no malformed hands, no plastic skin, no oversaturated colors.

Input images

Optional. Add 1-3 images to switch to editing mode. Each input image is billed once per request.

0/3 files

Aspect ratio

Quality

Resolution

Images (n)1

110

Estimate $0.0453.06 cr

1K Medium x 1 image + 0 input images

Ready

History

Generated Grok Imagine Image 2.0 tasks will appear here.

充值前先算清测试成本。

定价是分辨率（1K/2K）× 质量（Low/Medium）的简单矩阵。从单张样张成本开始，选择合适的测试预算。

First Test Cost

Text-to-Image - 1K - Low quality

1K Low prompt-only

Credits2.04

One 1K Low prompt-only image

Approx. Cost$0.030

About 333 tests with $10 in credits.

Start with the 1K Low tier for drafts, then switch to Medium or 2K for the final check. Input images add a per-image fee once per request.

EvoLink 价$0.030

官方价$0.040

节省-25%

Testing Budget Guide

Pick an amount based on how many tests you expect.

Add Credits

$10

About 333 tests

Good for a first validation.

$50

About 1667 tests

Good for prompt iteration.

$100

About 3333 tests

Good before production integration.

Common Cost Examples

Draft iteration1K Low prompt-only

$0.030/image-25%

2.04 cr/image$0.040 官方价

Reference edit1K Medium + one input image

$0.053/image-25%

3.57 cr/image$0.070 官方价

Final quality check2K Medium prompt-only

$0.060/image-25%

4.08 cr/image$0.080 官方价

Estimated cost for one generated image. Multiply the output rate by n for multi-image requests; input image fees are charged once per request.

Model Pricing

Item	Rule	Rate	Billing
1K · Low	Fastest tier (~10s) for drafts and prompt iteration.	$0.030/image-25% 2.04 cr/image$0.040 官方价	Per output image
1K · Medium (default)	Default tier with better detail; generation may take 10-75s.	$0.045/image-25% 3.06 cr/image$0.060 官方价	Per output image
2K · Low	Higher resolution with the fast quality tier.	$0.045/image-25% 3.06 cr/image$0.060 官方价	Per output image
2K · Medium	Highest tier for final quality checks.	$0.060/image-25% 4.08 cr/image$0.080 官方价	Per output image

1K · Low

Fastest tier (~10s) for drafts and prompt iteration. - Per output image

$0.030/image-25%

2.04 cr/image$0.040 官方价

1K · Medium (default)

Default tier with better detail; generation may take 10-75s. - Per output image

$0.045/image-25%

3.06 cr/image$0.060 官方价

2K · Low

Higher resolution with the fast quality tier. - Per output image

$0.045/image-25%

3.06 cr/image$0.060 官方价

2K · Medium

Highest tier for final quality checks. - Per output image

$0.060/image-25%

4.08 cr/image$0.080 官方价

Optional Add-ons & Billing NotesInput image pricing and multi-image requests.

Item	Rule	Rate	Billing
Input images	Applied to each input image in image_urls (max 3), charged once per request regardless of n.	$0.0075/image-25% 0.51 cr/image$0.010 官方价	Per input image
Multiple outputs (n)	n can be 1-10. The output rate is multiplied by n; failed tasks are not charged.	Output rate × n	Per request

Grok Imagine Image 2.0 文生图与图像编辑能力

Grok Imagine Image 2.0 使用官方模型 ID grok-imagine-image-2.0，在一个 API 路由中支持文生图和 1-3 张参考图编辑，并提供 13 种比例、1K/2K 输出及单次最多 10 张批量生成。

更多提示词示例

输入

文本 / 1-3 张图

输出

1-10 张图

比例

13 种预设 + auto

质量 × 分辨率

Low/Medium × 1K/2K

Grok Imagine Image 2.0 指南与对比

已确认功能与发布说明了解 EvoLink 当前路由已确认的能力，以及仍需要实测的边界。API 接入指南从 API Key 开始，完成生成、编辑、任务轮询、回调与失败处理。Grok Imagine Image 2.0 对比 GPT Image 2对比参考图工作流、输出尺寸、控制参数与生产路由选择。

Grok Imagine Image 2.0 核心图像能力

用一条提示词生成商业主视觉

从文本构建具有明确主体、光影和构图的广告场景，再用 13 种比例适配不同内容渠道。

能力场景示意图由 GPT Image 2 生成；Grok 实际输出会随提示词、参考图和参数变化。

用参考图完成定向编辑

以一张参考图保留主体识别特征，同时按提示词修改环境、光线、材质或视觉方向。

能力场景示意图由 GPT Image 2 生成；Grok 实际输出会随提示词、参考图和参数变化。

融合 2-3 张参考图

把主体、商品和环境等不同参考来源组合成一张连贯画面，并用 <IMAGE_0>、<IMAGE_1>、<IMAGE_2> 精确指定每张图的作用。

能力场景示意图由 GPT Image 2 生成；Grok 实际输出会随提示词、参考图和参数变化。

Grok Imagine Image 2.0 API 适合哪些图像工作流

生成营销视觉

用一条提示词生成广告、海报、社交素材，13 种比例可选。

用输入图编辑

在 image_urls 传 1-3 张图即切换到编辑模式，无需单独的编辑模型名。

用 n 批量出图

单次请求最多生成 10 张；输出费按 n 倍计，输入图费不变。

按档位控制成本

用 1K Low 迭代提示词，最终输出再切 Medium 或 2K。

图像 API 能力定位与模型选择

特性	Grok Imagine Image 2.0	Seedream 5.0 Pro	GPT Image
起价	约 $0.030 / 张	约 $0.034 / 张起	按 token 或档位
输出档位	Low/Medium × 1K/2K	1K / 2K	质量档位
参考图输入	最多 3 张	最多 10 张	支持
单次出图数	1-10 张	1 张	因模型而异
适合场景	快速迭代、批量创意、参考图编辑	广告、商品创意、图像编辑	OpenAI 图像工作流

起价

Grok Imagine Image 2.0约 $0.030 / 张

Seedream 5.0 Pro约 $0.034 / 张起

GPT Image按 token 或档位

输出档位

Grok Imagine Image 2.0Low/Medium × 1K/2K

Seedream 5.0 Pro1K / 2K

GPT Image质量档位

参考图输入

Grok Imagine Image 2.0最多 3 张

Seedream 5.0 Pro最多 10 张

GPT Image支持

单次出图数

Grok Imagine Image 2.01-10 张

Seedream 5.0 Pro1 张

GPT Image因模型而异

适合场景

Grok Imagine Image 2.0快速迭代、批量创意、参考图编辑

Seedream 5.0 Pro广告、商品创意、图像编辑

GPT ImageOpenAI 图像工作流

模型 ID、参考图与输出限制

官方模型 ID，两种图像模式

模型 ID 为 grok-imagine-image-2.0。只发提示词就是文生图；加 1-3 张输入图即切换到图像编辑模式，不需要另一个编辑模型 ID。

质量与分辨率相互独立

quality（low/medium）控制生成强度与速度；resolution（1k/2k）控制输出像素。二者独立且都进价格矩阵，四个组合分别按基准价 1×/1.5×/1.5×/2× 计价。

输入图费只收一次

每张输入图每次请求加收基准价的 0.25×，与 n 无关。任务失败不扣费。

为什么通过 EvoLink 统一 API 接入 Grok Imagine Image 2.0

生成前查看实时成本

提交任务前，可根据分辨率、质量、输出数量和参考图查看当前价格与预计积分。

统一 API

一个 API Key 通用于 Grok、Seedream、Nano Banana、GPT Image、视频、音频和大语言模型。

统一余额

在同一个控制台跟踪积分、消费和模型用量。

任务状态追踪

随时查看图像任务处于已提交、处理中、已完成还是失败状态。

结果稳定托管

生成结果转存至 EvoLink CDN，上游临时链接过期后仍可访问。

Grok 模型家族

Grok Imagine Video 1.5

xAI 视频生成线路：文生视频、图生视频、参考图生视频一体，时长 1-15 秒。

查看

Grok Imagine Video

第一代 Grok Imagine 视频线路，支持文生视频和图生视频。

查看

Grok 4.6

xAI 旗舰文本模型，擅长推理、编码和智能体工作流。

查看

EvoLink 上的其他图像模型

Seedream 5.0 Pro

BytePlus 图像线路，1K/2K 输出档位、最多 10 张参考图、指令式编辑。

查看

Nano Banana 2

Google 图像模型，高质量生成与灵活的创意工作流。

查看

GPT Image 2

OpenAI 图像线路，支持提示词、参考图和编辑工作流。

查看

Qwen Image Edit

图像编辑线路，适合直接变换和局部创意修改。

查看

常见问题

Grok Imagine Image 2.0 API 的官方模型 ID 是什么？

官方模型 ID 是 grok-imagine-image-2.0。文生图和 1-3 张参考图编辑使用同一个 ID，无需切换到单独的编辑模型。

Grok Imagine Image 2.0 怎么收费？

按分辨率 × 质量矩阵计价：1K Low 为基准价，1K Medium 和 2K Low 为 1.5 倍，2K Medium 为 2 倍。输出费按 n 倍计，每张输入图每次请求加收基准价的 0.25 倍。

接入 API 前能先试用吗？

可以。用 Playground 测试出图质量、估算积分，并在接入产品前查看请求 JSON。

quality 和 resolution 有什么区别？

quality（low/medium）控制生成强度——low 约 10 秒，medium 10-75 秒但细节更好；resolution（1k/2k）控制输出像素。二者是独立参数，都影响价格。

怎么用它做图像编辑？

在 image_urls 里传 1-3 个图片 URL 并附上提示词，模型会自动切换到编辑模式。多张图时在提示词中用 <IMAGE_0>、<IMAGE_1>、<IMAGE_2> 指代各图。

能用 n 一次生成多张图吗？

可以。单次请求 n 可取 1-10，输出费按 n 倍计，输入图费每次请求只收一次。

输入图收费吗？

收。image_urls 中每张输入图加收基准价的 0.25 倍，每次请求只收一次、与 n 无关。仅接受公网 http(s) URL，不支持 base64 上传。

能自定义像素尺寸吗？

不能。size 只接受 13 种比例预设加 auto，不支持自定义宽 × 高；分辨率由独立的 1k/2k 参数控制。

生成失败会怎样？

失败不扣费——预扣金额全额退还，包括上游拒绝、内容审核拦截和超时。

充值后去哪里继续？

回到 Playground 继续测试，或创建 API Key，用 model 为 grok-imagine-image-2.0 调用 /v1/images/generations。

API Reference

Select endpoint

Endpoints

Authentication

All APIs require Bearer Token authentication.

Header

Authorization: 
Bearer YOUR_API_KEY

Get API Key

POST

/v1/images/generations

Generate Image

Grok Imagine Image 2.0 is xAI's image generation and editing model — text-to-image and image editing share the same model name. Omit image_urls for text-to-image; pass 1-3 reference images and it automatically switches to image editing, no model change needed.

Asynchronous processing mode, use the returned task ID to .

Generated image links are valid for 24 hours, please save them promptly.

Request Parameters

modelstringRequiredDefault: grok-imagine-image-2.0

Image generation model name. Text-to-image and image editing share this model name; the mode switches automatically depending on whether image_urls is provided.

Value	Description
grok-imagine-image-2.0	Grok Imagine Image 2.0 model

Examplegrok-imagine-image-2.0

promptstringRequired

Prompt describing the image you want to generate, or how to edit the reference images you provide.

Notes

Multi-image reference syntax: use <IMAGE_0>, <IMAGE_1>, <IMAGE_2> in the prompt to refer to the 1st, 2nd and 3rd reference image respectively
Indexes start at 0 and map one-to-one to the order of the image_urls array
Example: Place the person from <IMAGE_0> into the scene of <IMAGE_1>

ExampleCyberpunk Tokyo street at night, neon lights reflecting on the wet pavement

image_urlsarrayOptional

Reference image URL list for image-to-image and image editing functions.

Notes

Number of input images per request: 0~3 (omitted = text-to-image, 1~3 = image editing)
Only publicly accessible http / https image URLs are supported; base64 and data URLs are not supported
Supported file formats: .jpeg, .jpg, .png, .webp
Image URLs must be directly accessible by the server, or directly download when accessed (typically ending with image file extensions such as .png, .jpg)
In image editing scenarios the reference images incur an additional charge, counted once per request and not multiplied by n

Example["https://example.com/person.png", "https://example.com/scene.png"]

sizestringOptionalDefault: auto

Aspect ratio of the generated image, defaults to auto.

Value	Description
auto	The model decides the ratio itself; omitting this parameter is equivalent to auto (output is usually portrait)
1:1	Square
4:3 / 3:4	Classic landscape / portrait
3:2 / 2:3	Standard landscape / portrait
16:9 / 9:16	Widescreen / mobile portrait
2:1 / 1:2	Ultra-wide / ultra-tall
19.5:9 / 9:19.5	Full-screen phone landscape / portrait
20:9 / 9:20	Ultra-wide landscape / portrait

Notes

Values outside the 13 supported ratios are not supported; custom WIDTHxHEIGHT pixel sizes are not accepted

Example16:9

resolutionstringOptionalDefault: 1K

Pixel tier of the output image, defaults to 1K; supports the 1K and 2K tiers.

Value	Description
1K	Standard resolution (default)
2K	Higher resolution

Notes

This model does not support 4K
Values are case-insensitive

Example1K

qualitystringOptionalDefault: medium

Generation quality tier, controls how deeply the model thinks, defaults to medium.

Value	Description
low	Faster output, lower cost
medium	Better image quality and detail

Notes

This model only supports the low / medium tiers; other values such as high are not supported
quality (quality tier) and resolution (pixel tier) are independent and can be combined freely
Values are case-insensitive

Examplemedium

nintegerOptionalDefault: 1

Number of images to generate, range 1~10, defaults to 1.

Value	Description
1-10	Any integer between 1 and 10

Notes

Each image is billed independently, cost grows linearly with n
The additional charge for reference images is counted once per request and is not multiplied by n
When the task completes, results returns n independent image links

Example1

callback_urlstringOptional

HTTPS callback address after task completion.

Notes

Triggered when task is completed, failed, or cancelled; sent after billing confirmation
HTTPS only; callbacks to internal IP addresses are prohibited; max length 2048 chars
Timeout: 10s, max 3 retries on failure (after 1s / 2s / 4s)
Callback body format is consistent with the task query API response; a 2xx response is considered successful, other status codes trigger a retry

Examplehttps://your-domain.com/webhooks/image-task-completed

Examples

Request Example (Text to Image)

{
  "model": "grok-imagine-image-2.0",
  "prompt": "Cyberpunk Tokyo street at night, neon lights reflecting on the wet pavement",
  "size": "16:9",
  "resolution": "2K",
  "quality": "medium"
}

Request Example (Multi-image Editing)

{
  "model": "grok-imagine-image-2.0",
  "prompt": "Place the person from <IMAGE_0> into the scene of <IMAGE_1>, keeping the lighting consistent",
  "size": "16:9",
  "resolution": "1K",
  "quality": "medium",
  "image_urls": [
    "https://example.com/person.png",
    "https://example.com/scene.png"
  ]
}

Request Example (Batch Generation, Fast Tier)

{
  "model": "grok-imagine-image-2.0",
  "prompt": "A cute robot in pixel art style",
  "size": "1:1",
  "resolution": "1K",
  "quality": "low",
  "n": 4
}

Response Example

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "grok-imagine-image-2.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 3.06,
    "user_group": "default"
  }
}

Completed Usage Example

{
  "id": "task-unified-1757156493-imcg5zqt",
  "object": "image.generation.task",
  "created": 1757156493,
  "model": "grok-imagine-image-2.0",
  "status": "completed",
  "type": "image",
  "progress": 100,
  "results": ["https://cdn.evolink.ai/images/generated-image.jpg"],
  "result_data": [
    {
      "url": "https://cdn.evolink.ai/images/generated-image.jpg",
      "mime_type": "image/jpeg"
    }
  ],
  "usage": {
    "credits_used": 3.06,
    "cost": { "credits": 3.06, "cny": 0.31, "usd": 0.05 }
  }
}