Documentation 2026-10-05 22:59 UTC to 2026-10-06 22:57 UTC

41| grok-4.20-0309-non-reasoning | T0: 37, T1: 50, T2: 75, T3: 125, T4: 208 | T0: 10M, T1: 15M, T2: 25M, T3: 45M, T4: 85M |41| grok-4.20-0309-non-reasoning | T0: 37, T1: 50, T2: 75, T3: 125, T4: 208 | T0: 10M, T1: 15M, T2: 25M, T3: 45M, T4: 85M |

42| grok-build-0.1 | T0: 37, T1: 50, T2: 75, T3: 125, T4: 208 | T0: 10M, T1: 15M, T2: 25M, T3: 45M, T4: 85M |42| grok-build-0.1 | T0: 37, T1: 50, T2: 75, T3: 125, T4: 208 | T0: 10M, T1: 15M, T2: 25M, T3: 45M, T4: 85M |

43| grok-4.20-multi-agent-0309 | T0: 9, T1: 12, T2: 18, T3: 31, T4: 56 | T0: 2.5M, T1: 3.7M, T2: 6.2M, T3: 11M, T4: 21M |43| grok-4.20-multi-agent-0309 | T0: 9, T1: 12, T2: 18, T3: 31, T4: 56 | T0: 2.5M, T1: 3.7M, T2: 6.2M, T3: 11M, T4: 21M |

44| grok-imagine-image | T0: 6, T1: 12, T2: 25, T3: 50, T4: 100 | — |

45| grok-imagine-image-quality | T0: 6, T1: 12, T2: 25, T3: 50, T4: 100 | — |44| grok-imagine-image-quality | T0: 6, T1: 12, T2: 25, T3: 50, T4: 100 | — |

45| grok-imagine-image | T0: 6, T1: 12, T2: 25, T3: 50, T4: 100 | — |

46| grok-imagine-image-2.0 | T0: 6, T1: 12, T2: 25, T3: 50, T4: 100 | — |46| grok-imagine-image-2.0 | T0: 6, T1: 12, T2: 25, T3: 50, T4: 100 | — |

47| grok-imagine-video | T0: 10, T1: 20, T2: 39, T3: 79, T4: 158 | — |47| grok-imagine-video | T0: 10, T1: 20, T2: 39, T3: 79, T4: 158 | — |

48| grok-imagine-video-1.5 | T0: 10, T1: 20, T2: 39, T3: 79, T4: 158 | — |

49| grok-imagine-video-1.5-lite | T0: 10, T1: 20, T2: 39, T3: 79, T4: 158 | — |48| grok-imagine-video-1.5-lite | T0: 10, T1: 20, T2: 39, T3: 79, T4: 158 | — |

49| grok-imagine-video-1.5 | T0: 10, T1: 20, T2: 39, T3: 79, T4: 158 | — |

50 50 

51**Voice & Audio**51**Voice & Audio**

52 52 

10 10 

11* `aspect_ratio` ("1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "2:3" | "3:2" | "9:19.5" | "19.5:9" | "9:20" | "20:9" | "1:2" | "2:1" | "21:9" | "5:2" | "auto")11* `aspect_ratio` ("1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "2:3" | "3:2" | "9:19.5" | "19.5:9" | "9:20" | "20:9" | "1:2" | "2:1" | "21:9" | "5:2" | "auto")

12 12 

13* `deferred` (boolean | null) — If set, the request returns immediately with a \`request\_id\` and the

14 image is generated in the background. Poll \`GET /v1/images/\{request\_id}\`

15 for the result. Only \`response\_format: "url"\` is supported in this mode.

16 

13* `model` (string | null) — Model to be used.17* `model` (string | null) — Model to be used.

14 18 

15* `n` (integer | null) — Number of images to be generated19* `n` (integer | null) — Number of images to be generated

16 20 

21* `output` (object)

22 

23 * `upload_urls` (array\<string>, required) — Signed URLs to upload the generated images via HTTP PUT, one per

24 image: the list length must equal \`n\` (default 1). Each PUT sends a

25 \`Content-Type\` equal to the image's \`mime\_type\` in the response

26 (\`image/jpeg\` unless the requested quality produces PNG), so sign the

27 URL for that type or without a Content-Type constraint.

28 

17* `prompt` (string) — Prompt for image generation.29* `prompt` (string) — Prompt for image generation.

18 30 

19* `resolution` ("1k" | "2k" | "1.5k")31* `resolution` ("1k" | "2k" | "1.5k")

169 181 

170* `aspect_ratio` ("1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "2:3" | "3:2" | "9:19.5" | "19.5:9" | "9:20" | "20:9" | "1:2" | "2:1" | "21:9" | "5:2" | "auto")182* `aspect_ratio` ("1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "2:3" | "3:2" | "9:19.5" | "19.5:9" | "9:20" | "20:9" | "1:2" | "2:1" | "21:9" | "5:2" | "auto")

171 183 

184* `deferred` (boolean | null) — If set, the request returns immediately with a \`request\_id\` and the

185 edit is generated in the background. Poll \`GET /v1/images/\{request\_id}\`

186 for the result. Only \`response\_format: "url"\` is supported in this mode.

187 

172* `image` (object)188* `image` (object)

173 189 

174 * `file_id` (string | null) — File ID from the xAI Files API. Mutually exclusive with \`url\`.190 * `file_id` (string | null) — File ID from the xAI Files API. Mutually exclusive with \`url\`.

193 209 

194* `n` (integer | null) — Number of image edits to be generated.210* `n` (integer | null) — Number of image edits to be generated.

195 211 

212* `output` (object)

213 

214 * `upload_urls` (array\<string>, required) — Signed URLs to upload the generated images via HTTP PUT, one per

215 image: the list length must equal \`n\` (default 1). Each PUT sends a

216 \`Content-Type\` equal to the image's \`mime\_type\` in the response

217 (\`image/jpeg\` unless the requested quality produces PNG), so sign the

218 URL for that type or without a Content-Type constraint.

219 

196* `prompt` (string, required) — Prompt for image editing.220* `prompt` (string, required) — Prompt for image editing.

197 221 

198* `resolution` ("1k" | "2k" | "1.5k")222* `resolution` ("1k" | "2k" | "1.5k")