用途：把 xAI 一方 Grok Imagine 图像 API 当作生产系统使用，而非提示词玩具。图像生成与编辑走同步 REST 接口，与异步的视频请求/轮询契约不同。
主要能力：支持文生图与自然语言编辑。生成端点 POST https://api.x.ai/v1/images/generations，编辑端点 POST https://api.x.ai/v1/images/edits，鉴权用 Authorization: Bearer {XAI_API_KEY}，Content-Type: application/json。当前模型为 grok-imagine-image-quality（含日期别名与 -latest，已退役的 grok-imagine-image-pro 重定向至此）和 grok-imagine-image。生成可选 n（文档称最多 10 张）、aspect_ratio、resolution（1k/2k）、response_format（url 或 b64_json）、storage_options、user。编辑需 prompt、model 及 image 或 images（最多三张）之一，来源用 url 或 file_id，支持 JPEG/PNG/WebP，多图用 <IMAGE_0> 等引用。
使用方式：用最小权限的团队级密钥，从密钥管理器或 XAI_API_KEY 读取，勿写入源码、日志或 URL。可先查询可用模型：curl --fail-with-body --silent --show-error https://api.x.ai/v1/image-generation-models -H "Authorization: Bearer ${XAI_API_KEY}"。OpenAI SDK 的 images.edit() 因发送 multipart 不兼容，需用直接 HTTP、xAI SDK 或兼容的 Vercel AI SDK。
适用场景：生产图像生成、多参考图编辑、批量排队图像任务、成本与产物生命周期管理。
限制：当前 REST 图像 schema 无 seed、负向提示、guidance scale、mask、输出格式选择等字段；无自助区域参数，数据驻留需书面承诺；直接响应 URL 仅文档称短暂，Batch URL 一小时过期；价格与模型信息以 2026-07-09 官方页面为准，部署前需复核。部分细节（如 max_prompt_length 单位）暂未提供。