直接答案：Grok 图片 API 用生成端点处理文生图，用编辑端点处理换背景、局部调整和参考图任务。适合电商主图、海报和批量视觉素材；先用标准模型验证提示词，再按成片要求选择质量档。
1. Grok 生图 API 是什么
Grok 图片生成 API 是 Grok 媒体接口中的图片能力，使用 POST /v1/images/generations 创建图片，使用 POST /v1/images/edits 编辑输入图片。平台统一处理认证、路由和用量记录，应用只需要配置 Base URL、API Key 与模型代号。
| 用途 | 请求端点 | 主要输入 | 返回结果 |
|---|---|---|---|
| 文生图 | POST /v1/images/generations | model、prompt、尺寸或宽高比 | 生成图片 URL 或内容字段 |
| 图片编辑 | POST /v1/images/edits | 输入图片、prompt，可选参考图或遮罩 | 编辑后的图片 URL 或内容字段 |
可用性提示：图片生成需要 API Key 所属分组开启图片生成权限，具体模型以模型广场和创建密钥页面为准。
2. Grok 图片生成 API 请求示例
下面是 OpenAI 风格 JSON 请求。将 YOUR_API_KEY 和模型代号替换为控制台显示的值：
curl https://www.codex789.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image",
"prompt": "极简科技风耳机电商主图，深色背景，柔和侧光",
"resolution": "1k",
"aspect_ratio": "16:9"
}'平台会将常见的 size 参数转换为 Grok 所需的 resolution 与 aspect_ratio。
3. 图片编辑与参考图
编辑接口支持 image、images、reference_images 和 mask 字段。图片对象使用 url；旧式 image_url 也会被兼容转换。源码限制编辑源图片最多 3 张，适合商品换背景、局部重绘和风格调整。
curl https://www.codex789.com/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-quality",
"prompt": "保留产品主体，换成明亮的春季户外场景",
"image": {"url": "https://example.com/product.png"}
}'4. Grok 图片模型与价格
Sub2API 内置 Grok Imagine 图片模型映射包括快速图片、质量图片和 Image 2。图片价格受模型、1k/2k 档位、分组倍率和 API Key 配置影响，本站页面不写死人民币单价。
grok-imagine-image：快速图片方向。grok-imagine-image-quality：质量图片方向。grok-imagine-image-2.0：Image 2 方向。
实际可用型号、倍率和价格以模型广场及 API 密钥页面显示为准。
5. Grok 图片生成 API FAQ
Grok 生图支持哪些尺寸？
平台会处理 1k/2k 分辨率和常见宽高比，具体组合以当前模型返回和控制台说明为准。
Grok 图片 API 是否兼容 OpenAI SDK？
接口路径和 JSON 结构按 OpenAI 风格设计，通常只需修改 Base URL、API Key、模型和图片参数。
为什么模型可见但请求没有权限？
模型目录与 API Key 分组权限可能不同，请在创建密钥页面确认图片生成权限。