Documentation 2026-09-19 23:59 UTC to 2026-09-20 23:01 UTC

40| 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 |40| 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-build-0.1 | T0: 37, T1: 50, T2: 75, T3: 125, T4: 208 | T0: 10M, T1: 15M, T2: 25M, T3: 45M, T4: 85M |41| 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-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 |42| 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-imagine-image-quality | T0: 6, T1: 12, T2: 25, T3: 50, T4: 100 | — |

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

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

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 | — |

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

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

48 48 

168 168 

169 * `text_tokens` (integer, required) — Total text prompt token used (cached + non-cached text tokens).169 * `text_tokens` (integer, required) — Total text prompt token used (cached + non-cached text tokens).

170 170 

171 * `server_side_tool_usage_details` (object)

172 

173 * `code_interpreter_calls` (integer, required) — Number of code interpreter calls.

174 

175 * `document_search_calls` (integer, required) — Number of document search calls.

176 

177 * `file_search_calls` (integer, required) — Number of file search calls.

178 

179 * `image_generation_calls` (integer, required) — Number of image generation calls.

180 

181 * `mcp_calls` (integer, required) — Number of MCP calls.

182 

183 * `web_search_calls` (integer, required) — Number of web search calls.

184 

185 * `x_posts_fetched` (integer, required) — Number of X posts fetched across all X search calls, including nested

186 parent/quote posts and every post of a fetched thread, without

187 de-duplication. X search is billed per fetched item.

188 

189 * `x_search_calls` (integer, required) — Number of X search calls.

190 

191 * `x_users_fetched` (integer, required) — Number of X user profiles fetched across all X search calls, without

192 de-duplication. X search is billed per fetched item.

193 

171 * `total_tokens` (integer, required) — Total token used, the sum of prompt token and completion token amount.194 * `total_tokens` (integer, required) — Total token used, the sum of prompt token and completion token amount.

172 195 

173\*\*Request example:\*\*196\*\*Request example:\*\*

312 335 

313 * `text_tokens` (integer, required) — Total text prompt token used (cached + non-cached text tokens).336 * `text_tokens` (integer, required) — Total text prompt token used (cached + non-cached text tokens).

314 337 

338 * `server_side_tool_usage_details` (object)

339 

340 * `code_interpreter_calls` (integer, required) — Number of code interpreter calls.

341 

342 * `document_search_calls` (integer, required) — Number of document search calls.

343 

344 * `file_search_calls` (integer, required) — Number of file search calls.

345 

346 * `image_generation_calls` (integer, required) — Number of image generation calls.

347 

348 * `mcp_calls` (integer, required) — Number of MCP calls.

349 

350 * `web_search_calls` (integer, required) — Number of web search calls.

351 

352 * `x_posts_fetched` (integer, required) — Number of X posts fetched across all X search calls, including nested

353 parent/quote posts and every post of a fetched thread, without

354 de-duplication. X search is billed per fetched item.

355 

356 * `x_search_calls` (integer, required) — Number of X search calls.

357 

358 * `x_users_fetched` (integer, required) — Number of X user profiles fetched across all X search calls, without

359 de-duplication. X search is billed per fetched item.

360 

315 * `total_tokens` (integer, required) — Total token used, the sum of prompt token and completion token amount.361 * `total_tokens` (integer, required) — Total token used, the sum of prompt token and completion token amount.

316 362 

317\*\*Response example:\*\*363\*\*Response example:\*\*

98 98 

99 * `text_tokens` (integer, required) — Total text prompt token used (cached + non-cached text tokens).99 * `text_tokens` (integer, required) — Total text prompt token used (cached + non-cached text tokens).

100 100 

101 * `server_side_tool_usage_details` (object)

102 

103 * `code_interpreter_calls` (integer, required) — Number of code interpreter calls.

104 

105 * `document_search_calls` (integer, required) — Number of document search calls.

106 

107 * `file_search_calls` (integer, required) — Number of file search calls.

108 

109 * `image_generation_calls` (integer, required) — Number of image generation calls.

110 

111 * `mcp_calls` (integer, required) — Number of MCP calls.

112 

113 * `web_search_calls` (integer, required) — Number of web search calls.

114 

115 * `x_posts_fetched` (integer, required) — Number of X posts fetched across all X search calls, including nested

116 parent/quote posts and every post of a fetched thread, without

117 de-duplication. X search is billed per fetched item.

118 

119 * `x_search_calls` (integer, required) — Number of X search calls.

120 

121 * `x_users_fetched` (integer, required) — Number of X user profiles fetched across all X search calls, without

122 de-duplication. X search is billed per fetched item.

123 

101 * `total_tokens` (integer, required) — Total token used, the sum of prompt token and completion token amount.124 * `total_tokens` (integer, required) — Total token used, the sum of prompt token and completion token amount.

102 125 

103\*\*Request example:\*\*126\*\*Request example:\*\*

225 225 

226 * `web_search_calls` (integer, required) — Number of web search calls.226 * `web_search_calls` (integer, required) — Number of web search calls.

227 227 

228 * `x_posts_fetched` (integer, required) — Number of X posts fetched across all X search calls, including nested

229 parent/quote posts and every post of a fetched thread, without

230 de-duplication. X search is billed per fetched item.

231 

228 * `x_search_calls` (integer, required) — Number of X search calls.232 * `x_search_calls` (integer, required) — Number of X search calls.

229 233 

234 * `x_users_fetched` (integer, required) — Number of X user profiles fetched across all X search calls, without

235 de-duplication. X search is billed per fetched item.

236 

230 * `total_tokens` (integer, required) — Total tokens used.237 * `total_tokens` (integer, required) — Total tokens used.

231 238 

232* `user` (string | null) — A unique identifier representing your end-user, which can help xAI to monitor and detect abuse.239* `user` (string | null) — A unique identifier representing your end-user, which can help xAI to monitor and detect abuse.

478 485 

479 * `web_search_calls` (integer, required) — Number of web search calls.486 * `web_search_calls` (integer, required) — Number of web search calls.

480 487 

488 * `x_posts_fetched` (integer, required) — Number of X posts fetched across all X search calls, including nested

489 parent/quote posts and every post of a fetched thread, without

490 de-duplication. X search is billed per fetched item.

491 

481 * `x_search_calls` (integer, required) — Number of X search calls.492 * `x_search_calls` (integer, required) — Number of X search calls.

482 493 

494 * `x_users_fetched` (integer, required) — Number of X user profiles fetched across all X search calls, without

495 de-duplication. X search is billed per fetched item.

496 

483 * `total_tokens` (integer, required) — Total tokens used.497 * `total_tokens` (integer, required) — Total tokens used.

484 498 

485* `user` (string | null) — A unique identifier representing your end-user, which can help xAI to monitor and detect abuse.499* `user` (string | null) — A unique identifier representing your end-user, which can help xAI to monitor and detect abuse.