# 创建 Secret
<subtitle>使用 Secret.create 保存凭证。</subtitle>

使用 `Secret.create()` 保存凭证。名称由您指定，值会被加密存储，返回结果中只包含元数据，不包含值。

```python
from ucloud_sandbox import Secret

secret = Secret.create(
    "modelverse_api_key",
    "your-modelverse-api-key",
    metadata={"environment": "production"},
)

print(secret.secret_id)  # Secret ID
print(secret.version)    # 1
```

新创建的 Secret 版本号为 `1`。`metadata` 是可选的，用于给 Secret 打标签（如环境、负责人），不传时为空。

## 名称

- Secret 名称在项目内唯一。同名 Secret 已存在时创建会失败；如需修改值，请使用 [`Secret.update()`](/docs/agent-sandbox/secret/rotate.md)。
- 名称不能为空，也不能包含 `{`、`}` 或控制字符，否则 SDK 会直接抛出 `InvalidArgumentException`。

## 标识

每个 Secret 除名称外还有一个固定的 Secret ID。`Secret.get_info()`、`Secret.exists()`、`Secret.update()` 和 `Secret.destroy()` 既可以传名称，也可以传 Secret ID。