文档AEM 内容人工智能

设置 Adobe Developer Console 项目 configure-adc-project

最近更新： 2026年6月4日

创建对象：

  • Beginner
  • Developer
  • Admin

要调用 AEM 内容人工智能 Services API，您需要使用由 Adobe Developer Console（ADC）项目颁发的凭据。 本文将指导您创建项目、选择身份验证方式，以及生成每次 API 请求所需的凭据。

首先，访问您组织的 Adobe Developer Console。

先决条件 prerequisites

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

  • 您拥有访问组织 Adobe Developer Console 的权限。
  • 您已在 Adobe Admin Console 中被添加为 AEM 内容人工智能 Services 产品轮廓的​开发人员。 如果没有该角色，AEM 内容人工智能 Services API 卡片将显示为禁用状态，并且不会显示​ 服务器到服务器 ​身份验证选项。
  • 您已了解要选择的产品轮廓对应的项目编号和环境编号（例如：AEM User - publish - Program 12345 - Environment 67890）。
  • 您在该程序对应的 Admin Console 中拥有​ 系统管理员 ​角色。 利用此角色，可管理产品配置文件并将用户分配给环境。

选择身份验证方式 choose-auth

AEM 内容人工智能 Services 支持两种身份验证方式。 请选择与您的集成场景相匹配的方式：

方法
最适合
服务器到服务器
适用于无需用户参与即可调用 API 的后端服务。 返回短期有效的访问令牌。
API 密钥
适用于客户端或基于浏览器直接调用 API 的集成场景。 返回与指定允许域绑定的长期有效密钥。

服务器到服务器身份验证 s2s-auth

  1. 依次选择 API 和服务​和 API。

    显示 API 和服务的 Developer Console

  2. 按 AEM 内容人工智能 Services 进行筛选，然后选择​ 创建项目 ​以创建新项目；如果要将该服务添加到现有项目中，请选择​添加 API。

    note
    NOTE
    如果 API 卡片显示“需要许可证”并处于禁用状态，则您的 AEM as a Cloud Service 环境可能尚未完成现代化升级。 请参阅 AEM as a Cloud Service 环境现代化升级。

  3. 在​配置 API 对话框中，选择​ 服务器到服务器 ​身份验证方式。

    选择了服务器到服务器的“配置 API”对话框

    note tip
    TIP
    如果没有显示服务器到服务器选项，则说明当前配置集成的用户尚未被添加为产品轮廓中的“开发人员”。 请参阅启用服务器到服务器身份验证。

  4. 如有需要，可以重命名该凭据。 选择​下一步。

    Adobe Developer Console 中的步骤：在选择“下一步”之前，先为新的服务器到服务器凭据重命名

  5. 选择 AEM 用户 - 发布 - 项目 XXX - 环境 XXX 和/或 AEM 用户 - 创作 - 程序 XXX - 环境 XXX 产品轮廓，然后选择​保存。

    产品轮廓选择器，显示目标程序和环境对应的 AEM 用户发布轮廓和创作轮廓

  6. 查看 API 和身份验证配置。

    审核页面，汇总显示所选 API、身份验证类型和凭据名称

    审核页面详细信息，显示已分配给该凭据的产品轮廓

生成访问令牌 generate-token

  1. 在 ADC 项目中，进入​ 凭据 ​页面，然后选择​生成访问令牌。

    凭据页面，其中“生成访问令牌”按钮已突出显示

  2. 在每个 API 请求的 Authorization 请求头中包含该令牌：

    code language-http 
    Authorization: Bearer YOUR_ACCESS_TOKEN
    note warning
    WARNING
    请安全保存该令牌。 访问令牌会过期，因此需要定期重新生成。

API 密钥身份验证 api-key-auth

  1. 在将 AEM 内容人工智能 Services API 添加到项目时，请在​ 选择身份验证类型 ​对话框中选择 API 密钥。

    选择 API 密钥身份验证类型

  2. 确认 API 密钥凭据。

    添加 API 密钥凭据

  3. 若要限制哪些来源可以使用该密钥，请配置允许的域。

    配置允许的域

  4. 您的 API 密钥（客户端 ID）会显示在​ 已连接凭据 ​下。 选择​复制。

    从已连接凭据中复制 API 密钥

  5. 在每个 API 请求中包含该密钥：

    code language-http 
    x-api-key: YOUR_API_KEY

    您的项目现已准备就绪。 调用 AEM 内容人工智能 Services 时，请在每个请求中使用该密钥。

后续步骤 next-steps

recommendation-more-help
experience-manager-content-ai-help-content-ai