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

项目 API

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

什么是项目？

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

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

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

何时使用项目

当你需要执行以下操作时，你应该使用项目 API：

项目与推理配置文件

Projects API 和推理配置文件都在 Amazon Bedrock 中提供隔离、标记和访问控制功能，但它们因您使用的 API 而异。如果你使用与 OpenAI 兼容的 b edrock- APIs mantle 端点（使用 Mantle 推理引擎），请使用 Projects API。如果您将 Invo ke 或 Converse APIs 与基底运行时端点一起使用，请使用推理配置文件。虽然你可以将 Chat Completions API 与 bedrock-mantle 或基岩运行时端点一起使用，但我们建议你使用 Mantle 端点。

项目与 AWS 账户

AWS 账户和 AWS Org anizations 代表基础设施级别的账单和所有权界限。项目代表单个账户内的工作负载和应用程序边界。

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

项目入门

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

先决条件

在开始之前，请确保您满足以下条件：

步骤 1：设置您的环境

使用您的 Amazon 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 检索与 Projects API 兼容的模型列表：

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

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

使用带有成本监控和可观察性标签的 Create Project API 创建项目。请注意，目前软件开发工具包中仅支持 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/v1/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"

使用具有不同内容的项目 APIs

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

项目生命周期管理