跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Grok Image 2.0 图生图 API

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

图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 grok-imagine-image-2.0/image-to-image
类型 图像生成（图生图）
接口 POST /v1/tasks
价格 查看 HiAPI 实时定价

xAI Grok Imagine Image 2.0 图像编辑，使用一张公开参考图和自然语言指令完成改色、换景、风格迁移与局部重绘。

生产建议

生产环境建议
  • image 必须是可公开访问的单张 JPG、JPEG、PNG 或 WebP URL；不要传 image_urls 数组。
  • API Key 只保存在服务端；生产环境可通过 callback.url 接收任务终态通知。
  • aspect_ratio 虽然可以传入并会通过请求校验，但编辑时上游忽略它，输出比例以参考图为准。

适用场景

产品图改造

保留主体形状，快速修改颜色、材质、背景和光线。

input.imageinput.prompt
风格迁移

将照片转成插画、电影感或其他明确指定的视觉风格。

input.imageinput.prompt
单图精修

以一张参考图为基础进行自然语言驱动的局部或整体编辑。

input.imageinput.qualityinput.resolution

请求参数

model string 必填

固定填 grok-imagine-image-2.0/image-to-image。

示例 grok-imagine-image-2.0/image-to-image
input object 必填

模型输入参数。

prompt string 必填

对参考图执行的自然语言编辑指令。

image string 必填

一张可公开访问的 JPG、JPEG、PNG 或 WebP 参考图；当前契约只接受单张图片。

示例 https://static.hiapi.ai/example/inputs/sneaker.jpg
quality enum 可选

生成质量；medium 细节更好，low 延迟更低。

默认 medium 可选值: lowmedium
resolution enum 可选

输出分辨率档位。

默认 1k 可选值: 1k2k
aspect_ratio enum 可选

请求接受该字段，但图像编辑时上游会忽略它并以参考图为准。

默认 1:1 可选值: 1:116:99:164:33:43:22:32:11:219.5:9 +4
callback object 可选

可选回调配置；任务进入终态时通知你的服务。

url string 必填

传入 callback 时必填的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机，当前使用 final。

默认 final 可选值: final

用例示例

产品图改色

保留鞋型，将颜色改为电光蓝并生成 2k 棚拍图。

请求体
{
  "model": "grok-imagine-image-2.0/image-to-image",
  "input": {
    "prompt": "把鞋子改成鲜艳的电光蓝，保持原有形状，并放在干净的棚拍产品画面中",
    "image": "https://static.hiapi.ai/example/inputs/sneaker.jpg",
    "quality": "medium",
    "resolution": "2k",
    "aspect_ratio": "1:1"
  }
}
参考图编辑

使用英文指令编辑一张公开参考图。

请求体
{
  "model": "grok-imagine-image-2.0/image-to-image",
  "input": {
    "prompt": "Recolor the sneaker to vivid electric blue, keep the original shape and place it in a clean studio product shot",
    "image": "https://static.hiapi.ai/example/inputs/sneaker.jpg",
    "quality": "medium",
    "resolution": "2k",
    "aspect_ratio": "1:1"
  }
}

获取结果

  1. 提交成功后立即返回 taskId。
  2. 轮询 GET /v1/tasks/:id 或等待 callback.url 的终态通知。
  3. status=success 时从 output[].url 下载编辑后的图片。
  4. status=fail 时根据错误信息修正请求后再重试。

常见问题

图生图需要传什么图片字段？

在 input.image 中传一张可公开访问的 JPG、JPEG、PNG 或 WebP URL；不要使用 image_urls 数组。

可以一次传多张参考图吗？

不可以。Grok Image 2.0 图生图的公开契约当前只接受单张参考图。

aspect_ratio 对图生图有效吗？

字段可以传入，但编辑时上游会忽略它，输出画幅以参考图为准。

如何获取编辑结果？

提交任务后读取 taskId，轮询 GET /v1/tasks/:id 或等待 callback.url；成功时从 output[].url 下载图片。

下一步