One-click Code Execution

POST

/302/sandbox/direct_run_code

Automatically create a sandbox, and destroy it immediately after execution. Optional feature to export sandbox files (if there are multiple files in the directory, they will be compressed into a zip file for export; a single file will be exported directly). This interface is recommended if continuous sandbox operations are not required.

Price: Sandbox runtime (seconds) * 0.001 PTC + Exporting sandbox files to the 302 file system (0.001 PTC/call)

Request

Header Params

Authorization

string

required

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

language

enum<string>

执行使用的编程语言

optional

If not specified or if the value is out of the selectable range, it will be treated as Python code.

Allowed values:

pythonrjavabashjs

Default:

python

code

string

代码

required

envs

object

环境变量

optional

Supports passing environment variables.

is_download

boolean

是否需要下载文件

optional

If the code's function is to generate files, enabling this option is required to obtain the files.

Default:

false

download_path

string

代码里文件的保存位置

optional

For Linux file paths, if the code does not specify a save path, you may omit it, and the system will return files from the default save directory

timeout

integer

沙盒执行的超时时间

optional

Default:

Example

{
    "code": "# 保存绘制的气温折线图为图片文件\nimport os\n\nimport matplotlib.pyplot as plt\n\n# 从之前整理的字典数据结构获取天气数据\nweather_data = {\n    '03月17日': {'最高气温': 16, '最低气温': 12},\n    '03月18日': {'最高气温': 21, '最低气温': 12},\n    '03月19日': {'最高气温': 22, '最低气温': 11},\n    '03月20日': {'最高气温': 22, '最低气温': 11},\n    '03月21日': {'最高气温': 24, '最低气温': 12},\n    '03月22日': {'最高气温': 25, '最低气温': 13},\n    '03月23日': {'最高气温': 26, '最低气温': 14}\n}\n\n# 提取日期、最高气温和最低气温\ndates = list(weather_data.keys())\nhighs = [data['最高气温'] for data in weather_data.values()]\nlows = [data['最低气温'] for data in weather_data.values()]\n\n# 创建折线图\nplt.figure(figsize=(10, 5))\nplt.plot(dates, highs, marker='o', label='最高气温 (℃)', color='red')\nplt.plot(dates, lows, marker='o', label='最低气温 (℃)', color='blue')\n\n# 添加标题和标签\nplt.title('未来一周广州天气气温折线图')\nplt.xlabel('日期')\nplt.ylabel('气温 (℃)')\nplt.xticks(rotation=45)\nplt.legend()\nplt.grid()\n\nprint(os.getcwd())\n\n# 保存图形为PNG文件\nplt.savefig('guangzhou_weather_temperature_chart.png')\nplt.close()\nprint(11)",
    "is_download": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/302/sandbox/direct_run_code' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "# 保存绘制的气温折线图为图片文件\nimport os\n\nimport matplotlib.pyplot as plt\n\n# 从之前整理的字典数据结构获取天气数据\nweather_data = {\n    '\''03月17日'\'': {'\''最高气温'\'': 16, '\''最低气温'\'': 12},\n    '\''03月18日'\'': {'\''最高气温'\'': 21, '\''最低气温'\'': 12},\n    '\''03月19日'\'': {'\''最高气温'\'': 22, '\''最低气温'\'': 11},\n    '\''03月20日'\'': {'\''最高气温'\'': 22, '\''最低气温'\'': 11},\n    '\''03月21日'\'': {'\''最高气温'\'': 24, '\''最低气温'\'': 12},\n    '\''03月22日'\'': {'\''最高气温'\'': 25, '\''最低气温'\'': 13},\n    '\''03月23日'\'': {'\''最高气温'\'': 26, '\''最低气温'\'': 14}\n}\n\n# 提取日期、最高气温和最低气温\ndates = list(weather_data.keys())\nhighs = [data['\''最高气温'\''] for data in weather_data.values()]\nlows = [data['\''最低气温'\''] for data in weather_data.values()]\n\n# 创建折线图\nplt.figure(figsize=(10, 5))\nplt.plot(dates, highs, marker='\''o'\'', label='\''最高气温 (℃)'\'', color='\''red'\'')\nplt.plot(dates, lows, marker='\''o'\'', label='\''最低气温 (℃)'\'', color='\''blue'\'')\n\n# 添加标题和标签\nplt.title('\''未来一周广州天气气温折线图'\'')\nplt.xlabel('\''日期'\'')\nplt.ylabel('\''气温 (℃)'\'')\nplt.xticks(rotation=45)\nplt.legend()\nplt.grid()\n\nprint(os.getcwd())\n\n# 保存图形为PNG文件\nplt.savefig('\''guangzhou_weather_temperature_chart.png'\'')\nplt.close()\nprint(11)",
    "is_download": true
}'

Responses

🟢200成功

application/json

Body

result

object

沙盒执行结果

required

stdout

array[string]

正常的输出信息

required

stderr

array[string]

异常信息

required

file

object

导出的文件链接

optional

Example

{"result":{"stdout":["/home/user\n","11\n"],"stderr":[],"file":{"url":"https://file.302.ai/gpt/imgs/20250325/32b6d14175364c9aba38c68caa8158c3.7z"}}}

🟠401没有权限

Modified at 2025-04-10 06:45:10

Markitdown (File conversion to md format)

Create Sandbox