Grok 生图 API

本文说明如何通过 JarlessAPI 调用 Grok Imagine 生图、改图。聊天客户端配置见 Grok Build。生视频见 Grok 生视频 API。

基本信息

项目	说明
Base URL	https://jarlessapi.com
认证	Authorization: Bearer <api_key>
分组	必须使用 Grok 分组，且分组已开启生图权限
路径	/v1/images/generations、/v1/images/edits（也可省略 /v1）

以下 cURL 示例在 Bash 中执行（macOS / Linux / WSL / Git Bash）。

export BASE_URL="https://jarlessapi.com"
export API_KEY="grok分组的apikey"

可用模型

你传的 model	实际上游	用途
grok-imagine	grok-imagine-image-quality	文生图（推荐）
grok-imagine-image-quality	同名	高质量生图
grok-imagine-image	同名	快速生图

文生图

POST /v1/images/generations

curl "$BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine",
    "prompt": "A cinematic 16:9 cyberpunk night market, rain-slick alley, neon magenta cyan amber signs, steam from street food, wet asphalt reflections, photorealistic, no watermark",
    "n": 1
  }'

已验证响应：

{
  "data": [
    {
      "mime_type": "image/jpeg",
      "url": "https://imgen.x.ai/xai-imgen/xai-tmp-imgen-....jpeg"
    }
  ]
}

默认图片地址在 data[0].url，需能访问返回的图片域名。若下载该地址超时，可在生成请求中加入 "response_format": "b64_json"，直接读取 data[0].b64_json。一次生成的图片尺寸以实际返回为准。

改图 / 图生图

POST /v1/images/edits

参考图可用 image、images、reference_images、mask。对象里用 url，旧字段 image_url 也会被归一化。也支持 multipart 上传。

curl "$BASE_URL/v1/images/edits" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "改成水彩风格，人物不要变",
    "image": { "url": "https://example.com/ref.png" }
  }'

请求字段

字段	必填	说明
model	是	见上方模型表
prompt	是	提示词
n	否	张数，默认 1
image / images / reference_images	改图时	URL 字符串或 { "url": "..." }
mask	否	蒙版图
aspect_ratio	否	画幅，例如 1:1、16:9、9:16
resolution	否	图片分辨率档位：1k、2k，以模型支持范围为准
response_format	否	默认返回 URL；b64_json 直接返回图片 base64

指定画幅时使用 aspect_ratio，例如 "aspect_ratio": "16:9"。size 会被转换为上游的画幅与分辨率档位，不代表可以任意指定输出像素尺寸；最终尺寸以返回图片为准。

异步任务

长请求可走：

POST /v1/images/generations/async
POST /v1/images/edits/async
GET  /v1/images/tasks/{task_id}

异步需后台打开对象存储，否则返回 404。只有 OpenAI / Grok 分组支持。

常见错误

现象	原因
403 无生图权限	分组未开启图片生成
503 grok_media_no_eligible_account	Grok 账号不可做媒体。API Key 账号默认可；OAuth 账号需通过媒体资格探测
404 Images API is not supported	当前 Key 不是 Grok / OpenAI / Gemini 分组
TUI /imagine 报 Incorrect API key	/imagine 不走 JarlessAPI，请用本页接口