跳到主要内容

Grok Imagine

grok-imagine-image 与 grok-imagine-image-quality 通过 PopGo 的 OpenAI Images 兼容入口提供同步图片生成和编辑能力。Grok 图片的分辨率和比例字段与普通 OpenAI 图片参数不同，PopGo 会根据标准 size、resolution 和 aspect_ratio 做对应转换。

调用地址​

POST https://api.popgo.site/v1/images/generations
POST https://api.popgo.site/v1/images/edits
Authorization: Bearer YOUR_API_KEY

文生图使用 JSON；编辑请求使用 multipart 文件上传。图片生成不是异步视频任务，不需要轮询。

模型与规格​

模型分辨率比例
grok-imagine-image1K、2K1:1、16:9、9:16、4:3、3:4、3:2、2:3
grok-imagine-image-quality以实时能力页为准，当前按 2K 档位配置同上

PopGo 可以从 size 推导分辨率和比例。例如 2048x1152 会转换为 2K 与 16:9。如果同时传 resolution、aspect_ratio 和 size，优先确保三者表达的是同一个规格。

字段​

字段类型必填说明
modelstring是使用上表的公开模型 ID
promptstring是生成或编辑描述
resolutionstring否1K 或 2K；quality 模型以实时配置为准
aspect_ratiostring否仅支持表中七种比例
sizestring否WIDTHxHEIGHT；PopGo 将其转换为上游所需规格
ninteger否返回数量，默认 1；按模型与价格页能力设置
response_formatstring否url 或 b64_json
imagefile编辑时multipart 参考图，数量和格式以实时能力为准

文生图示例​

curl https://api.popgo.site/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "prompt": "雨夜霓虹灯下的城市街道，写实摄影",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "n": 1,
    "response_format": "url"
  }'

也可以使用标准尺寸：

{
  "model": "YOUR_MODEL",
  "prompt": "山谷中的玻璃温室，清晨阳光",
  "size": "2048x1152"
}

图像编辑示例​

curl https://api.popgo.site/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=YOUR_MODEL" \
  -F "image=@reference.png" \
  -F "prompt=保留主体外观，把背景改成黄昏海边"

响应与排查​

响应遵循 OpenAI Images 形式：data[].url 是图片地址，data[].b64_json 是不带 data:image/...;base64, 前缀的 Base64 内容。生成完成后请及时下载 URL。

  • resolution 必须是 1K 或 2K，不能传 4K。
  • aspect_ratio 必须使用表中值；任意比例会在提交前返回 400。
  • size 必须是合法的 WIDTHxHEIGHT，宽高不能超过 2K 能力范围。
  • 不要额外传 quality、style 等上游未确认字段；模型名中的 quality 是模型 ID 的一部分，不等于请求字段。
  • 参考图编辑使用 multipart 文件；本地路径不能直接作为 URL 发送。

计费使用模型与价格页中的当前配置；n、分辨率档位和参考图输入可能影响额度。