在 Sandbox 中使用

import uuid

from ppio_sandbox import PPIO

ppio = PPIO()

secret_name = f"openai-example-{uuid.uuid4().hex[:12]}"
openai_api_key = "your-openai-api-key"

# 1. 创建一个团队级 Secret。真实值会被加密存储；
#    只有允许列表中的主机才会进行替换。
ppio.secret.create(
    name=secret_name,
    value=openai_api_key,
    hosts=["api.openai.com"],
    description="Sandbox Secrets example",
)

# 2. 创建 Sandbox，并将环境变量映射到该 Secret 名称。
#    环境变量中保存的是占位符，而不是真实值。
sandbox = ppio.sandbox.create(
    secret_envs={"OPENAI_API_KEY": secret_name},
)

try:
    # 3. 在 Sandbox 内运行代码。它从环境变量读取占位符，
    #    并将其放入 HTTPS 请求头发送；由于 api.openai.com 在允许列表中，
    #    代理会在传输过程中替换为真实值。
    result = sandbox.commands.run(
        'curl -s https://api.openai.com/v1/models '
        '-H "Authorization: Bearer $OPENAI_API_KEY"'
    )
    print(result.stdout)
finally:
    # 4. 完成后终止 Sandbox。
    sandbox.kill()

import 'dotenv/config'
import { randomUUID } from 'crypto'
import { PPIO } from 'ppio-sandbox'

const ppio = new PPIO()

const secretName = `openai-example-${randomUUID().slice(0, 12)}`
const openaiApiKey = "your-openai-api-key"

// 1. 创建一个团队级 Secret。真实值会被加密存储；
//    只有允许列表中的主机才会进行替换。
await ppio.secret.create({
  name: secretName,
  value: openaiApiKey,
  hosts: ['api.openai.com'],
  description: 'Sandbox Secrets example',
})

// 2. 创建 Sandbox，并将环境变量映射到该 Secret 名称。
//    环境变量中保存的是占位符，而不是真实值。
const sandbox = await ppio.sandbox.create({
  secretEnvs: { OPENAI_API_KEY: secretName },
})

try {
  // 3. 在 Sandbox 内运行代码。它从环境变量读取占位符，
  //    并将其放入 HTTPS 请求头发送；由于 api.openai.com 在允许列表中，
  //    代理会在传输过程中替换为真实值。
  const result = await sandbox.commands.run(
    'curl -s https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY"'
  )
  console.log(result.stdout)
} finally {
  // 4. 完成后终止 Sandbox。
  await sandbox.kill()
}

# 1. 创建一个团队级 Secret（--from-env 从本地环境变量读取真实值，
#    避免密钥进入 shell 历史；--host 为允许列表主机）
ppio secret create openai-example \
  --host api.openai.com \
  --from-env OPENAI_API_KEY \
  --description "Sandbox Secrets example"

# 2. 创建 Sandbox，并将环境变量映射到该 Secret 名称（--secret-env 可重复传入）。
#    环境变量中保存的是占位符，而不是真实值。
ppio sandbox create base -d --secret-env OPENAI_API_KEY=openai-example

# 3. 在 Sandbox 内运行命令。发往允许列表主机的请求头中的占位符
#    会在代理层被替换为真实值。
ppio sandbox exec <sandbox_id> 'curl -s https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY"'

# 4. 完成后终止 Sandbox。
ppio sandbox kill <sandbox_id>