Set up an Adobe Developer Console Project configure-adc-project

To call the AEM Content AI Services API, you need credentials issued by an Adobe Developer Console (ADC) project. This page walks you through creating the project, selecting an authentication method, and generating the credential you include with every API request.

Go to Adobe Developer Console for your organization to begin.

Prerequisites prerequisites

Before you begin, ensure the following:

  • You have access to Adobe Developer Console for your organization.
  • You are added as a Developer on the AEM Content AI Services product profile in Adobe Admin Console. Without this role, the AEM Content AI Services API card appears disabled and the Server-to-Server authentication option is hidden.
  • You know the program and environment numbers for the product profile you want to select (for example, AEM User - publish - Program 12345 - Environment 67890).

Choose an Authentication Method choose-auth

AEM Content AI Services supports two authentication methods. Pick the one that matches your integration:

Method
Best for
Server-to-Server
Backend services that call the API without user interaction. Returns a short-lived access token.
API Key
Client-side or browser-based integrations that call the API directly. Returns a long-lived key scoped to allowed domains.

Server-to-Server Authentication s2s-auth

  1. Select APIs and services, then APIs.

    Developer Console showing APIs and services

  2. Filter by AEM Content AI Services, then select Create Project to start a new project, or Add API if you are adding the service to an existing project.

    note
    NOTE
    If the API card is disabled with a “License required” message, your AEM as a Cloud Service environment may not be modernized. See Modernization of AEM as a Cloud Service environment.
  3. In the Configure API dialog, select Server-to-Server authentication.

    Configure API dialog with Server-to-Server selected

    note tip
    TIP
    If the Server-to-Server option is not available, the user setting up the integration is not added as a Developer to the Product Profile. See Enable Server-to-Server authentication.
  4. If needed, rename the credential. Select Next.

    Adobe Developer Console step to rename the new Server-to-Server credential before selecting Next

  5. Select the AEM User - publish - Program XXX - Environment XXX and/or AEM User - author - Program XXX - Environment XXX Product Profile, then select Save.

    Product Profile picker showing the AEM User publish and author profiles for the target program and environment

  6. Review the API and authentication configuration.

    Review screen summarizing the selected API, authentication type, and credential name

    Review screen detail showing the assigned product profiles for the credential

Generate an Access Token generate-token

  1. In your ADC project, go to Credentials and select Generate access token.

    Credentials page with the Generate access token button highlighted

  2. Include the token in the Authorization header of every API request:

    code language-http
    Authorization: Bearer YOUR_ACCESS_TOKEN
    
    note warning
    WARNING
    Store the token securely. It expires and must be regenerated periodically.

API Key Authentication api-key-auth

  1. When adding the AEM Content AI Services API to your project, select API Key in the Select authentication type dialog.

    Select API Key authentication type

  2. Confirm the API Key credential.

    Add API Key credential

  3. To restrict which origins can use the key, configure allowed domains.

    Configure allowed domains

  4. Your API Key (Client ID) appears under Connected credentials. Select Copy.

    Copy API Key from Connected credentials

  5. Include the key in every API request:

    code language-http
    x-api-key: YOUR_API_KEY
    

    Your project is now ready. Use the key with every request to AEM Content AI Services.

Next Steps next-steps

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