Skip to main content
POST
cURL
这是 Grok 图片 API 的编辑接口。

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json
prompt
string
必填

提示词

model
enum<string>
默认值:grok-imagine-1.0-edit

图片编辑模型。

可用选项:
grok-imagine-1.0-edit,
grok-imagine-image,
grok-imagine-image-quality
refer_images
string[]

参考图像列表,目前只支持一个图像

示例:
aspect_ratio
enum<string>

输出宽高比;不传时由模型决定。 grok-imagine-1.0-edit 支持:1:1(社交媒体、头像、缩略图)、16:9(横屏图片、封面、桌面背景)、9:16(手机竖屏、短视频封面、Stories)、3:2(横向摄影)、2:3(纵向摄影、海报)。 grok-imagine-imagegrok-imagine-image-quality 额外支持:4:3(演示文稿、传统横屏画面)、3:4(肖像、竖版设计)、2:1(横向 Banner、页头)、1:2(纵向 Banner、长图)、19.5:9(横向智能手机屏幕)、9:19.5(竖向智能手机壁纸)、20:9(横向超宽屏幕)、9:20(竖向超宽屏幕)、auto(由模型根据提示词自动选择比例)。

可用选项:
1:1,
16:9,
9:16,
3:2,
2:3,
4:3,
3:4,
2:1,
1:2,
19.5:9,
9:19.5,
20:9,
9:20,
auto
resolution
enum<string>
默认值:1k

输出分辨率。1k 为标准分辨率(所有模型支持);2k 为更高分辨率(仅 grok-imagine-imagegrok-imagine-image-quality 支持)。

可用选项:
1k,
2k
n
integer
默认值:2

生成图片数量 1 - 4

必填范围: 1 <= x <= 4
hook_url
string

回调地址,任务完成或失败将通过请地址进行通知,通知数据结构与fetch结构 [blocked]一致。如果未设置,则需要请求fetch接口 [blocked]进行查询

示例:

"https://example.com/callback"

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填
示例:
最后修改于 2026年3月30日