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

图片生成模型。

Grok Imagine 系列:

  • grok-imagine-1.0
  • grok-imagine-2.0

Grok Image 系列:

  • grok-imagine-image
  • grok-imagine-image-quality
  • grok-imagine-image-2.0
可用选项:
grok-imagine-1.0,
grok-imagine-2.0,
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
enable_pro
boolean
默认值:true

grok-imagine-1.0grok-imagine-2.0 支持此参数;grok-imagine-2.0 仅允许为 true。其他模型不支持此参数。

quality
enum<string>

图片质量。仅 grok-imagine-image-2.0 支持此参数。

可用选项:
low,
medium
aspect_ratio
enum<string>
默认值:1:1

图片宽高比。 grok-imagine-1.0 支持: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

输出分辨率。Grok Image 系列grok-imagine-imagegrok-imagine-image-qualitygrok-imagine-image-2.0)支持 1k2k

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

生成图片数量 1 - 4

hook_url
string

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

示例:

"https://example.com/callback"

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

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