Skip to main content
Core.Today
|
Billing note Sub-agent tokens are billed on top of your own prompt and answer, so every turn has a floor of several thousand tokens regardless of input length (measured: a one-word prompt settled 4,266 tokens โ‰ˆ 9 credits). Use it for research-grade questions, not quick chat. Chat Completions is rejected upstream (400) - call POST /llm/grok/v1/responses.
xAISlowUltra

Grok 4.20 Multi-Agent

Grok 4.20 Multi-Agent beta (0309 snapshot) - deep-research style multi-agent orchestration with a 1M-token context window. Served through the Responses API only.

2,323/4,645credits
input / output ยท per 1M tokens
Multi-agent deep research (beta) - sub-agent tokens are billed
1M context window
Responses API only (/v1/responses) - Chat Completions is rejected with 400
Prompt caching with discounted cache reads
Long-context tier: prompts reaching 200K tokens bill the whole request at 2x rates

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Model Specifications

Context Window
1M
tokens
Max Output
33K
tokens
Training Cutoff
2025-11
Compatible SDK
OpenAI

Capabilities

Vision
Function Calling
Streaming
JSON Mode
System Prompt

Token Pricing (per 1M tokens)

Token TypeCreditsUSD Equivalent
Input Tokens2,323$1.55
Output Tokens4,645$3.10
Cached Tokens371.6$0.25

* 1,500 credits โ‰ˆ $1 (actual charges may vary based on usage)

Quick Start

curl -X POST "https://api.core.today/llm/grok/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer cdt_your_api_key" \
  -d '{
  "model": "grok-4.20-multi-agent-0309",
  "instructions": "You are a research analyst. Cite the evidence you rely on.",
  "input": "Compare the three leading approaches to long-context retrieval in 2026 and recommend one for a legal-document pipeline.",
  "max_output_tokens": 4096
}'

Parameters

ParameterTypeRequiredDefaultDescription
modelstringYes-Model ID, e.g. "grok-4.20-multi-agent-0309".
inputstring | arrayYes-Responses API input - a plain string or an array of role/content messages (replaces `messages`).
instructionsstringNo-System-level instructions (replaces the `system` message).
max_output_tokensintegerNo4096Cap on the visible answer. Sub-agent and reasoning tokens are billed separately and are not limited by this value.
streambooleanNofalseStream the response as server-sent events.

Examples

Deep research (Responses API)

Responses API request - the only endpoint this model accepts. A research-grade question amortizes the per-turn token floor.

curl -X POST "https://api.core.today/llm/grok/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer cdt_your_api_key" \
  -d '{
  "model": "grok-4.20-multi-agent-0309",
  "instructions": "You are a research analyst. Cite the evidence you rely on.",
  "input": "Compare the three leading approaches to long-context retrieval in 2026 and recommend one for a legal-document pipeline.",
  "max_output_tokens": 4096
}'

Tips & Best Practices

1Call POST /llm/grok/v1/responses - Chat Completions returns 400 for this model. With the OpenAI SDK use client.responses.create(...) with base_url https://api.core.today/llm/grok/v1
2Budget for a per-turn floor of roughly 4K tokens (โ‰ˆ9 credits): the orchestrator's cached system context and sub-agent reasoning are billed even when your prompt is one line. Pick a single-agent Grok for short Q&A
3max_output_tokens caps only the visible answer - it does not cap sub-agent or reasoning tokens
4Keep prompts under 200K tokens to stay on the standard rate (2x above that)

Use Cases

Deep research over long documents with multi-step synthesis
Complex analysis where parallel sub-tasks pay off
Agentic workflows that need a 1M shared context