The Gemini API code execution feature enables the model to generate and run
Python code and learn iteratively from the results until it arrives at a final
output. You can use this code execution capability to build applications that
benefit from code-based reasoning and that produce text output. For example,
you could use code execution in an application that solves equations or
processes text.

The Gemini API provides code execution as a tool, similar to
[function calling](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/models/function-calling.md.txt).
After you add code execution as a tool, the model decides when to use it.

## Supported models

#### Click to expand supported models

- [Gemini Robotics ER 2](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/robotics-er-2.md.txt) preview
- [Gemini 4 Hydrogen](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/4-hydrogen.md.txt)
- [Gemini 4 Carbon for cyber](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/4-carbon.md.txt#cyber)
- [Gemini 4 Carbon](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/4-carbon.md.txt)
- [Gemini 4 Argon Cyber Permissive](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/4-argon.md.txt#cyber)
- [Gemini 4 Argon](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/4-argon.md.txt)
- [Gemini 3.8 Flash Cyber](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-8-flash-cyber.md.txt)
- [Gemini 3.8 Flash](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-8-flash.md.txt)
- [Gemini 3.7 Flash](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-7-flash.md.txt)
- [Gemini 3.6 Flash](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-6-flash.md.txt)
- [Gemini 3.5 Flash-Lite](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-5-flash-lite.md.txt)
- [Gemini 3.5 Flash](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-5-flash.md.txt)
- [Gemini 3.1 Pro](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-1-pro.md.txt) preview
- [Gemini 3.1 Flash-Lite](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-1-flash-lite.md.txt)
- [Gemini 3 Flash](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-flash.md.txt) preview
- [Gemini 2.5 Pro](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/2-5-pro.md.txt)
- [Gemini 2.5 Flash-Lite](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/2-5-flash-lite.md.txt)
- [Gemini 2.5 Flash](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/2-5-flash.md.txt)

### Limitations

- The feature doesn't support file I/O.
- Code execution can run for a maximum of 30 seconds before timing out.

## Example syntax

### curl

```bash
PROJECT_ID = myproject
REGION = us-central1
MODEL_ID = gemini-2.0-flash-001

https://${REGION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${REGION}/publishers/google/models/${MODEL_ID}:generateContent \
  -d '{
    "contents": [{
      ...
    }],
    "tools": [{
      "code_execution":  {}
    }]
  }'
```

## Parameter list

See [examples](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/models/code-execution-api.md.txt#examples) for implementation details.

### Python

To enable code execution, specify a code execution `tool` in your request.

#### `CodeExecution`

Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/models/code-execution-api.md.txt#executablecode) and [CodeExecutionResult](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/models/code-execution-api.md.txt#codeexecutionresult) which are input and output to this tool.

#### `Part`

|---|---|
| `executable_code` | Optional: `ExecutableCode` Code generated by the model that is meant to be executed. See Code Execution \[API\]. |
| `code_execution_result` | Optional: `CodeExecutionResult` Result of executing the \[ExecutableCode\]. See Code Execution \[API\]. |

#### `ExecutableCode`

|---|---|
| `language` | Required: `string (enum)` Supported programming languages for the generated `code`. <br /> Supported: - `PYTHON` |
| `code` | Required: `string` The code to be executed. See Code Execution \[API\]. |

#### `CodeExecutionResult`

|---|---|
| `outcome` | Required: `string (enum)` Outcome of the code execution. <br /> Possible outcomes: - Code execution completed successfully. (`OUTCOME_OK`) - Code execution finished but with a failure. `stderr` should contain the reason. (`OUTCOME_FAILED`) - Code execution ran for too long, and was cancelled. There may or may not be a partial output present. (`OUTCOME_DEADLINE_EXCEEDED`) |
| `output` | Required: `string` Contains `stdout` when code execution is successful, `stderr` or other description otherwise. See Code Execution \[API\]. |

## Examples

Here are illustrations of how you can submit a query and function declarations to the model.

### Basic use case

### curl

```bash
PROJECT_ID = myproject
REGION = us-central1
MODEL_ID = gemini-2.0-flash-001

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://${REGION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${REGION}/publishers/google/models/${MODEL_ID}:generateContent \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{
        "text": "Calculate 20th fibonacci number. Then find the nearest palindrome to it."
      }]
    }],
    "tools": [{'codeExecution': {}}],
  }'
```

### Python

```python
from google import genai
from google.genai.types import Tool, ToolCodeExecution, GenerateContentConfig

client = genai.Client()
model_id = "gemini-2.0-flash-001"

code_execution_tool = Tool(
    code_execution=ToolCodeExecution()
)
response = client.models.generate_content(
    model=model_id,
    contents="Calculate 20th fibonacci number. Then find the nearest palindrome to it.",
    config=GenerateContentConfig(
        tools=[code_execution_tool],
        temperature=0,
    ),
)
for part in response.candidates[0].content.parts:
    if part.executable_code:
        print(part.executable_code)
    if part.code_execution_result:
        print(part.code_execution_result)
# Example response:
# code='...' language='PYTHON'
# outcome='OUTCOME_OK' output='The 20th Fibonacci number is: 6765\n'
# code='...' language='PYTHON'
# outcome='OUTCOME_OK' output='Lower Palindrome: 6666\nHigher Palindrome: 6776\nNearest Palindrome to 6765: 6776\n'
```

### Enable code execution on the model

To enable basic code execution, see
[Code execution](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/tools/code-execution.md.txt#enable_code_execution_on_the_model).

## What's next

- Learn more about how to [Generate content with the
  Gemini API](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/models/inference).
- Learn more about [Function
  calling](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/tools/function-calling).