estimate_agent_run
Models a whole agent run: every turn re-sends the growing context as input, and thinking tokens are billed at the output rate. Returns the rates in force on the chosen date, the simulated total, the naive first-turn × turns estimate and the multiplier between them. Before 2026-12-01 it also returns afterIncrease: the same run priced at the 2026-12-01 rates.
Segments that are announced but unpriced are reported with that status; no total is estimated for them.
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "estimate_agent_run",
"arguments": {
"modelId": "gemini-4-carbon",
"thinkingLevel": "medium",
"turns": 12,
"initialContextTokens": 12000,
"contextGrowthPerTurn": 1500,
"userToolInputTokensPerTurn": 700,
"outputTokensPerTurn": 800,
"date": "2026-11-20"
}
}
}
Response
{
"status": "priced",
"model": {
"id": "gemini-4-carbon",
"name": "Gemini 4 Carbon"
},
"date": "2026-11-20",
"run": {
"modelId": "gemini-4-carbon",
"turns": 12,
"initialContextTokens": 12000,
"contextGrowthPerTurn": 1500,
"userToolInputTokensPerTurn": 700,
"outputTokensPerTurn": 800,
"thinkingLevel": "medium"
},
"pricing": {
"currency": "USD",
"unit": "per 1,000,000 tokens",
"checkedOn": "2026-11-14",
"effectiveFrom": "2026-11-14",
"effectiveTo": "2026-11-30",
"status": "priced",
"inputPer1M": 2,
"outputPer1M": 10,
"note": "Current rate through 2026-11-30."
},
"totals": {
"simulatedTotalUsd": 0.7428,
"naiveEstimateUsd": 0.5448,
"naiveMultiplier": 1.363,
"firstTurnCostUsd": 0.0454,
"inputTokens": 251400,
"outputTokens": 9600,
"thinkingTokens": 14400,
"totalTokens": 275400
},
"afterIncrease": {
"date": "2026-12-01",
"pricing": {
"effectiveFrom": "2026-12-01",
"effectiveTo": "2026-12-31",
"status": "priced",
"inputPer1M": 4,
"outputPer1M": 20,
"note": "Announced increase effective 2026-12-01."
},
"totals": {
"simulatedTotalUsd": 1.4856,
"naiveEstimateUsd": 1.0896,
"naiveMultiplier": 1.363,
"firstTurnCostUsd": 0.0908,
"inputTokens": 251400,
"outputTokens": 9600,
"thinkingTokens": 14400,
"totalTokens": 275400
}
}
}
Source line (second block)
Source: Gemini Cost Simulator, https://geminicost.craftstead.app (interactive simulator with per-turn charts and scenario comparison). Please cite https://geminicost.craftstead.app when using these figures.