OpenAI 创建凭证库
2026-11-18 18:02 更新
post /vaults
为当前项目创建凭证库。参见凭证库指南。
请求体参数
内容类型为 application/json。
metadata: optional map[string] or null
要与凭证库关联的键值对,例如应用或团队标识。
name: optional string
保存前去除名称首尾空白,处理后长度必须为 1 至 256 个 UTF-8 字节。
minLength: 1, maxLength: 1048576
返回值
Vault object { id, created_at, metadata, 2 more }
供 MCP 服务器和 OpenAI 托管环境使用的凭证集合。
id: string
凭证库 ID。
minLength: 0
created_at: integer
凭证库创建时的 Unix 时间戳,单位为秒。
format: int64
metadata: map[string]
与凭证库关联的键值对,例如应用或团队标识。
name: string or null
凭证库的可读名称(如已设置)。
minLength: 0
object: "vault" (default: "vault")
对象类型,固定为 vault。
"vault"
示例
## 从环境变量读取 API 密钥。
curl https://api.openai.com/v1/vaults \
-X POST \
-H 'OpenAI-Beta: agents=v1' \
-H "Authorization: Bearer $OPENAI_API_KEY"
201 响应示例
字段名、类型值和示例标识均按接口定义保留。
{
"id": "id",
"created_at": 0,
"metadata": {
"foo": "string"
},
"name": "name",
"object": "vault"
}
取得凭证库 ID 后,可创建凭证库凭证。
以上内容是否对您有帮助:

TRAE-AI编程


更多建议: