Grok 图像接口

接口说明

生图、编辑与视频

本站提供 Grok / xAI 通用图片与视频接口，支持文生图、JSON 图片编辑、文生视频和参考图生视频，可供 sub2api 等兼容下游调用。API 地址为 https://y.junlistudio.com/v1，使用本站 API Key，通过 Authorization: Bearer YOUR_API_KEY 鉴权。

请求使用 application/json；图片请求体上限 100 MiB，视频请求体上限 50 MiB。参考图支持 PNG、JPEG、WebP，每张最多 25 MiB，张数还受模型限制。模型、时长、比例和分辨率以本站模型目录为准。

POST/v1/images/generationsGrok / xAI JSON 文生图

POST/v1/images/editsGrok / xAI JSON 图片编辑，兼容 sub2api

图片生成与编辑

参数	类型	必填	说明
`model`	`string`	是	本站已启用的图片模型 ID，可通过 /v1/models 获取；以本站模型目录为准。
`prompt`	`string`	是	生成或编辑图片的文字指令。
`n`	`integer`	否	默认 1，目前仅支持 1；其他值会报错，不会多扣费或静默少返回。
`aspect_ratio`	`string`	否	如 1:1、16:9，需符合模型能力；auto 按模型能力决定，默认使用模型比例。
`resolution`	`string`	否	1k / 2k，默认 1k；需启用对应计费档位，也接受 1K / 2K。
`response_format`	`string`	否	url 或 b64_json；Grok 请求默认 url，结果位于 data[].url 或 data[].b64_json。
`image.url / images[].url`	`string`	编辑必填	单图使用 image，多图使用 images；支持公网 HTTP(S) URL、data:image/...;base64,...，以及 image_url 别名。

Grok 兼容 · 文生图POST /v1/images/generations

curl 'https://y.junlistudio.com/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "grok-image",
  "prompt": "生成一只坐在窗边的橘猫，摄影风格",
  "n": 1,
  "aspect_ratio": "1:1",
  "resolution": "1k",
  "response_format": "url"
}'

Grok 兼容 · JSON 图片编辑POST /v1/images/edits

curl 'https://y.junlistudio.com/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "grok-image",
  "prompt": "保持主体不变，把背景改成海边",
  "image": {
    "url": "data:image/png;base64,REPLACE_WITH_IMAGE_BASE64"
  },
  "n": 1,
  "resolution": "1k",
  "response_format": "b64_json"
}'

将示例占位符替换为图片 Base64，或把 image.url 换成实际公网图片地址；多图使用 "images":[{"url":"..."},{"url":"..."}]。支持 sub2api 转换后的 image=images[0] 格式。

sub2api 接入：选择 Grok / xAI 的 API Key 账号，填写本站地址与密钥，配置本站已启用的图片、视频模型及模型映射；确保最终路径与本文给出的路径一致。旧版 Responses 连通性探测不生成媒体；sub2api 的图片/视频测试会实际生成并计费。

当前兼容上述媒体接口；批量生图、图片流式输出、mask、Files API、视频编辑/续接、自定义存储和音频参考尚未支持。

Grok 视频生成、查询与下载 →