Grok 生图 API

Grok 生图 API

Grok 图片调用同样使用 OpenAI Images 兼容入口。模型 ID、图片输入格式和最终响应类型以当前模型列表及响应实际内容为准。

1. 接口总览

Base URL：https://mrxapi.com/v1。

2. 查询模型

复制curl "https://mrxapi.com/v1/models" \
  -H "Authorization: Bearer $MRXAPI_KEY"

只使用当前返回列表中的图片模型。模型名称、质量档位或图片编辑能力会因上游和分组不同而变化。

3. 文生图

复制curl --request POST "https://mrxapi.com/v1/images/generations" \
  -H "Authorization: Bearer $MRXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "清晨薄雾中的未来城市，超广角摄影，无文字",
    "n": 1,
    "size": "1024x1024"
  }'

size 是兼容参数，实际像素和比例由模型返回结果决定；如果业务需要固定规格，应在下载后校验或转换。

4. 图片编辑 / 图生图

根据当前模型要求使用 multipart 或 JSON 图片输入。对于 JSON 格式，可传可公开访问的 HTTPS 地址，或使用 Data URL：

复制{
  "model": "MODEL_ID",
  "prompt": "保留主体和构图，把背景改成黄昏海边",
  "image": {
    "url": "https://example.com/input.jpg",
    "type": "image_url"
  }
}

Data URL 会显著增大请求体；大图优先上传到访问受控、无登录拦截的 HTTPS 存储。不要在 URL 中暴露包含凭据的签名参数。

5. 读取结果

检查 data 数组中的 url 或 b64_json。临时 URL 不应被当作永久资产地址，成功后应立即下载并写入自己的对象存储。

6. 常见错误

400 多为模型、请求字段或图片输入格式错误；401 检查 Bearer Key；403 检查图片权限；404 检查 /v1/images/... 路径；429 降低并发并退避；5xx 保存 request id 后有限重试。