Create Sandbox

POST

/302/sandbox/create

After successful creation, the sandbox will automatically pause. When you call other sandbox operation interfaces, the sandbox will automatically reconnect, and after execution, it will pause again to avoid unnecessary costs. (Note: Pausing and reconnecting will take some time, approximately 5 seconds in total.)

Sandbox information is associated with the 302 API key, and you can only operate the sandbox of the current API key.

Price: Sandbox runtime (seconds) * 0.001 PTC

Request

Header Params

Authorization

string

required

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

max_alive_time

integer

最大的存活时间

required

sandbox_name

string

自定义的沙盒名字

optional

metadata

object

沙盒元数据

optional

envs

object

设置的环境变量

optional

Example

{
    "max_alive_time": 300,
    "metadata": {
        "user_id": "123"
    },
    "sandbox_name": "test_name",
    "envs": {
        "OPENAI_API_KEY": "xxxxxx"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/302/sandbox/create' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "max_alive_time": 300,
    "metadata": {
        "user_id": "123"
    },
    "sandbox_name": "test_name",
    "envs": {
        "OPENAI_API_KEY": "xxxxxx"
    }
}'

Responses

🟠401没有权限

application/json

Body

error

object

required

err_code

integer

required

message

string

required

message_cn

string

required

message_jp

string

required

type

string

required

Example

{
    "error": {
        "err_code": 0,
        "message": "string",
        "message_cn": "string",
        "message_jp": "string",
        "type": "string"
    }
}

🟢200成功

Modified at 2025-03-27 02:47:59

One-click Code Execution

Query Your Sandbox List