Grok Imagine

grok-imagine-1.5 文生图与 grok-imagine-1.5-edit 图片编辑，同步，返回 OpenAI Images 格式

POST/v1/images/generations

POST/v1/images/edits

Grok Imagine 文生图与图片编辑，两个模型各自只在一个端点提供。公共协议见图片生成总览。

项	值
模型	`grok-imagine-1.5`（文生图，`/v1/images/generations`）/ `grok-imagine-1.5-edit`（编辑，`/v1/images/edits`）
模式	同步，返回 OpenAI Images 格式
计费	按成功图片数，价格以定价页为准
媒体保留	结果 URL 为临时地址，请及时转存

快速开始

curl https://api.vibelab.me/v1/images/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5",
    "prompt": "一只坐在阳光窗台上的橘猫，油画风格",
    "size": "1:1",
    "n": 1
  }'

{"created": 1719820800, "data": [{"url": "https://..."}]}

模式选择

模式	模型	端点	怎么传参
文生图	`grok-imagine-1.5`	`/v1/images/generations`	顶层 `prompt`
图片编辑	`grok-imagine-1.5-edit`	`/v1/images/edits`	顶层 `prompt` + `image_urls`（至少一张）

请求参数

参数	类型	必填	默认	说明
`model`	string	是	-	`grok-imagine-1.5` 或 `grok-imagine-1.5-edit`
`prompt`	string	是	-	提示词 / 编辑指令
`size`	string	否	-	`1:1`、`16:9`、`9:16`、`3:2`、`2:3`
`n`	integer	否	`1`	输出张数
`image_urls`	string[]	编辑必填	-	参考图 URL，仅 `grok-imagine-1.5-edit` 使用，至少一张

请求示例

文生图

{
  "model": "grok-imagine-1.5",
  "prompt": "一只坐在阳光窗台上的橘猫，油画风格",
  "size": "1:1",
  "n": 1
}

图片编辑

curl https://api.vibelab.me/v1/images/edits \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5-edit",
    "prompt": "将背景改为纯白摄影棚",
    "image_urls": ["https://example.com/input.png"],
    "n": 1
  }'

响应

OpenAI Images 格式，图片在 data[].url，见图片生成总览。

计费

按成功图片数计费，请求前按 n 预扣，失败退款，规则见图片生成总览。

错误

HTTP	code	触发场景	处理
400	`invalid_request`	`grok-imagine-1.5-edit` 请求了 `/v1/images/generations`，或 `grok-imagine-1.5` 请求了 `/v1/images/edits`（`message` 为 `invalid image generation request`）	按上表选择端点

其余错误见图片生成总览。

注意事项

编辑模型走 /v1/images/generations（或文生图模型走 /v1/images/edits） → 400。

Grok Imagine

本页内容