xAI

Grok Imagine Image 2.0

grok-imagine-image-2.0/image-to-image

xAI 图像生成与编辑模型，指令遵循与复杂版式渲染较强，支持参考图迭代改图，可输出 1K/2K 多宽高比图像

grok-imagine-image-2.0/image-to-image grok-imagine-image-2.0/text-to-image

试用 grok-imagine-image-2.0/image-to-image

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

grok-imagine-image-2.0/image-to-image 每张

单价	$0.065

定位简介

grok-imagine-image-2.0 的图像编辑线路：上传一张参考图并给出编辑指令，模型在保持原有构图与关键细节的前提下完成改写与迭代调整。它更适合需要按复杂文字指令精确改图的开发者，例如海报版式、产品图与概念稿的多轮修订。通过 HiAPI.ai 统一接口调用，输入一张参考图与提示词即可获得编辑结果。

核心亮点

按指令编辑，保留原图构图——输出沿用参考图的取景与版式，模型只按提示词改动指定内容，避免整图重绘导致细节丢失。
复杂版式与文字排版更清晰——对含文字、分栏与复杂布局的物料，渲染清晰度较好，适合海报与封面类改稿。
多轮迭代逐步收敛——在同一参考图上反复提交编辑指令，关键视觉细节的保持度较好，便于逐步逼近目标效果。
质量与分辨率两档可选——quality 提供 low 与 medium 两档，resolution 支持 1k 与 2k，可按预览与出图阶段分配算力。

能力说明

参考图指令编辑：以一张 JPG、PNG 或 WebP 参考图加编辑提示词为输入，输出改写后的图像；适合替换元素、调整风格与局部重绘。

细粒度指令遵循：能还原提示词中的多项创作约束，长描述与多条件改图请求的落地程度较高，减少反复重试。

档位与分辨率控制：quality 选 low 可更快出预览，medium 为推荐默认；resolution 在 1k 与 2k 间切换，兼顾草稿与成稿。

按参考图取景输出：编辑时输出跟随参考图构图，aspect_ratio 参数虽可传但不影响结果，接入时无需为比例做额外适配。

适用场景

设计师基于现有版式改稿——上传海报或封面稿并描述修改点，得到保留版式结构的新稿，用于快速比对多版方案。
产品图的素材改写与再创作——以实拍产品图为参考改写背景与氛围，产出可直接用于详情页与投放素材的成图。
概念稿的多轮局部调整——在初稿上逐轮提交编辑指令，逐步修正细节，用于概念可视化阶段的方案收敛。
社交媒体与广告素材适配——基于同一参考图批量生成不同改法，产出多套竖版或方版素材用于渠道投放测试。

限制与选型建议

单次请求只接受一张参考图，无法做多图融合；输出质量仅 low 与 medium 两档，最高分辨率为 2k，超高清或印刷级需求需另行放大处理。编辑时宽高比随参考图固定，无法在请求中改变取景。模型发布较新，独立评测与长期稳定性数据有限，对结果一致性要求极高的批量生产建议先小样本验证。

常见问题

查看全部常见问题 →

Grok Image 2.0 Text to Image 主要适合什么任务？

支持 low/medium 质量档、1K/2K 输出和从方形到超宽画幅，适合产品、编辑、风景与角色视觉。
Grok Image 2.0 Text to Image 是否支持参考图？

当前线路是纯文生图，不接收参考图。
支持哪些输出规格？

当前页面展示 1K、2K 与 auto、1:1、16:9、9:16、4:3、3:4、2:1、1:2；最终可选项以 Playground 参数为准。
Grok Image 2.0 Text to Image 如何计费？

按成功生成的图片数量计费；不同分辨率或质量档如有差异，会在页面实时价格中显示。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：grok-imagine-image-2.0/image-to-image

routestring可选

当前固定值：default

inputobject必填

grok-imagine-image-2.0/image-to-image 和线路 default 的业务参数对象，见下方参数表。

imagestring必填

待编辑的参考图，取值为一个公开可访问的 JPG、JPEG、PNG 或 WebP 图片地址。

promptstring必填minLength 1

针对参考图的编辑指令，以文本形式描述期望的修改效果。

qualitystring可选默认值: "medium"

生成质量，取值形态为字符串，默认 medium（推荐值）；low 则生成更快。

可选项：lowmedium

resolutionstring可选默认值: "1k"

输出图像的分辨率，取值为字符串，默认 1k。

可选项：1k2k

aspect_ratiostring可选默认值: "1:1"

输出宽高比，取值为字符串，默认 1:1；编辑场景下该参数虽被接受但不生效，输出画面跟随参考图的构图。

可选项：1:116:99:164:33:43:22:32:1

显示全部（6 项）

1:219.5:99:19.520:99:20auto

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-image-2.0/image-to-image",
  "input": {
    "image": "…",
    "prompt": "…",
    "quality": "medium",
    "resolution": "1k",
    "aspect_ratio": "1:1"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-image-2.0/image-to-image",
    input: {
      "image": "…",
      "prompt": "…",
      "quality": "medium",
      "resolution": "1k",
      "aspect_ratio": "1:1"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine-image-2.0/image-to-image",
        "input": {
          "image": "…",
          "prompt": "…",
          "quality": "medium",
          "resolution": "1k",
          "aspect_ratio": "1:1"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}