跳转到内容
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/text-to-image
类型 图像生成（文生图）
接口 POST /v1/tasks
价格 查看 HiAPI 实时定价

xAI Grok Imagine Image 2.0 文生图，支持自然语言生成、1k/2k 输出和从方形到超宽画幅的多种构图。

生产建议

生产环境建议
  • API Key 只保存在服务端；统一任务接口返回 taskId，不要在浏览器中暴露密钥。
  • 生产环境可在请求体顶层传 callback.url，任务进入 success 或 fail 后由 HiAPI 通知你的服务。
  • quality 只支持 low 和 medium，resolution 只支持 1k 和 2k；其他值会被请求校验拒绝。

适用场景

快速创意探索

用自然语言快速生成概念图、社交素材和产品方向草稿。

input.promptinput.quality
横幅与宽画幅

使用 16:9、2:1、19.5:9 或 20:9 等比例制作横向素材。

input.aspect_ratio
可控输出尺寸

在低延迟的 1k 和更细致的 2k 之间选择输出档位。

input.resolution

请求参数

model string 必填

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

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

模型输入参数。

prompt string 必填

要生成的画面描述。

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/text-to-image",
  "input": {
    "prompt": "A premium editorial product photograph of a translucent glass camera aperture glowing over a dark studio surface",
    "quality": "medium",
    "resolution": "2k",
    "aspect_ratio": "16:9"
  }
}
中文产品概念图

使用中文提示词生成横版概念图。

请求体
{
  "model": "grok-imagine-image-2.0/text-to-image",
  "input": {
    "prompt": "深色摄影棚中的半透明玻璃光圈，内部发出洋红色光芒，高级商业产品摄影质感",
    "quality": "medium",
    "resolution": "2k",
    "aspect_ratio": "16:9"
  }
}

获取结果

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

常见问题

Grok Image 2.0 文生图的模型 ID 是什么？

请求中的 model 固定填写 grok-imagine-image-2.0/text-to-image。

支持哪些质量和分辨率？

quality 支持 low、medium；resolution 支持 1k、2k。默认分别为 medium 和 1k。

支持哪些画幅比例？

支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2、19.5:9、9:19.5、20:9、9:20 和 auto。

如何获取生成结果？

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

下一步