本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

项目 (OpenAI-compatible)

Amazon Bedrock Projects API 使用 API 为您的生成式 AI 工作负载提供应用程序级隔离。 OpenAI-compatible 项目使您能够通过改进整个组织的访问控制、成本跟踪和可观察性来组织和管理您的 AI 应用程序。

什么是项目？

项目是一个逻辑边界，用于在 Amazon Bedrock 中隔离应用程序、环境或实验等工作负载。项目提供以下功能：

项目允许您在生产环境中管理多个生成式 AI 工作负载，无需创建单独的 AWS 账户或组织，从而降低运营复杂性，同时保持安全性和监管。

每个 AWS 账户都有一个默认项目，所有推理请求都与该项目相关联。您可以使用项目 API 在您的账户中创建更多项目。

何时使用项目

当你需要时，你应该使用项目 API：

项目与推理概况

项目 API 和推理配置文件都在 Amazon Bedrock 中提供隔离、标记和访问控制功能，但它们因您使用的终端节点而异。如果你使用带有 b edrock-mantle 端点 OpenAI-compatible 的 API，请使用项目 API。如果你使用的是基准运行时端点（推荐用于新应用程序），请使用推理配置文件。聊天完成 API 在两个端点上都可用；项目 API 仅在上bedrock-mantle可用。

项目 vs. AWS accounts

AWS 账户和AWS 组织代表基础设施层面的账单和所有权边界。项目代表单个账户中的工作负载和应用程序边界。

使用项目代替单独的 AWS 账户可以：

项目入门

此页面引导您创建第一个项目、将其与推理请求关联以及管理项目资源。

先决条件

开始之前，请确保您已具备以下条件：

第 1 步：设置您的环境

使用您的亚马逊 Bedrock 凭证配置您的环境变量：

export OPENAI_API_KEY="<your-bedrock-key>"
export OPENAI_BASE_URL="https://bedrock-mantle.<your-region>.api.aws/v1"

<your-region>替换为您的 AWS 区域（例如，us-east-1、us-west-2）。

第 2 步：发现可用模型

使用 list() API 检索与项目 API 兼容的模型列表：

curl -X GET $OPENAI_BASE_URL/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

第 3 步：创建你的第一个项目

使用带有用于成本监控和可观察性的标签的创建项目 API。请注意，目前 SDK 仅支持 cURL。

curl -X POST $OPENAI_BASE_URL/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Project ABC",
    "tags": {
      "Project": "CustomerChatbot",
      "Environment": "Production",
      "Owner": "TeamAlpha",
      "CostCenter": "21524"
    }
  }' -v

响应：

{
  "arn": "arn:aws:bedrock-mantle:ap-northeast-1:673693429514:project/proj_5d5ykleja6cwpirysbb7",
  "created_at": 1772135628,
  "id": "proj_5d5ykleja6cwpirysbb7",
  "name": "Project ABC",
  "object": "organization.project",
  "status": "active",
  "tags": {
    "Owner": "TeamAlpha",
    "Project": "CustomerChatbot",
    "Environment": "Production",
    "CostCenter": "21524"
  }
}

重要注意事项：

第 4 步：将推理请求与您的项目关联起来

要将您的项目关联到推理请求，请在创建客户端时提供项目 ID：

cURL

curl -X POST $OPENAI_BASE_URL/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "OpenAI-Project: proj_5d5ykleja6cwpirysbb7" \
  -d '{
    "model": "openai.gpt-oss-120b",
    "input": "Explain the benefits of using projects in Amazon Bedrock"
  }'

Python

from openai import OpenAI
client = OpenAI(project="proj_5d5ykleja6cwpirysbb7")

使用该客户端提出的所有推理请求都将与指定的项目相关联，从而确保适当的隔离、成本跟踪和访问控制。

第 5 步：验证您的项目设置

列出所有项目以验证您的项目是否已成功创建：

curl -X GET $OPENAI_BASE_URL/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY"

响应：

{
  "data": [
    {
      "arn": "arn:aws:bedrock-mantle:ap-northeast-1:673693429514:project/default",
      "created_at": 1764460800,
      "id": "default",
      "name": "default",
      "object": "organization.project",
      "status": "active",
      "tags": {}
    },
    {
      "arn": "arn:aws:bedrock-mantle:ap-northeast-1:673693429514:project/proj_2z766pfxmkij5vwubv75",
      "created_at": 1771823259,
      "id": "proj_2z766pfxmkij5vwubv75",
      "name": "Project ABC",
      "object": "organization.project",
      "status": "active",
      "tags": {}
    }
  ],
  "first_id": "default",
  "has_more": false,
  "last_id": "proj_znaruqn723npmjqnxqfd",
  "object": "list"
}

后续步骤

现在你已经创建了你的第一个项目，你可以：

处理 项目

此页面提供有关在项目的整个生命周期中管理项目的详细信息。

创建项目

基础项目创建

使用名称、描述和标签创建项目：

curl -X POST $OPENAI_BASE_URL/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Development Environment",
    "tags": {
      "Project": "InternalTools",
      "Environment": "Development",
      "Owner": "TeamAlpha",
      "CostCenter": "30156"
    }
  }'

每个账户最多可以有 1000 个项目。

推荐的命名规范

使用清晰的描述性名称来反映您的组织结构：

列出项目

列出所有项目

检索您账户中的所有项目：

curl -X GET $OPENAI_BASE_URL/organization/projects \
  -H "Authorization: Bearer $OPENAI_API_KEY"

检索项目详情

获取有关特定项目的详细信息：

curl -X GET $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY"

更新项目

修改项目属性，例如名称：

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Chatbot v2"
  }'

管理项目标签

添加新标签或更新现有标签值：

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "add_tags": {
      "Application": "WebApp",
      "Version": "2.0",
      "Team": "Engineering"
    }
  }'

通过其密钥删除特定标签：

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_5d5ykleja6cwpirysbb7 \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "remove_tag_keys": ["Version", "OldTagKey"]
  }'

存档项目

存档不再使用的项目：

curl -X POST $OPENAI_BASE_URL/organization/projects/proj_abc123/archive \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json"

使用具有不同 API 的项目

Responses API

from openai import OpenAI

client = OpenAI(project="proj_abc123")

response = client.responses.create(
    model="openai.gpt-oss-120b",
    input="What are the key features of Amazon Bedrock?"
)
print(response)

Chat Completions API

from openai import OpenAI

client = OpenAI(project="proj_abc123")

response = client.chat.completions.create(
    model="openai.gpt-oss-120b",
    messages=[
        {"role": "user", "content": "Explain how projects improve security"}
    ]
)

print(response.choices[0].message.content)

最佳实践

推荐的项目结构

每个应用程序一个项目：为每个不同的应用程序或服务创建单独的项目。

├── CustomerChatbot-Production
├── CustomerChatbot-Staging
├── CustomerChatbot-Development
├── InternalSearch-Production
└── InternalSearch-Development

项目生命周期管理