Oracle Cloud Infrastructure Documentation

Using Applications

Use an application endpoint to invoke a hosted application in OCI Generative AI.

Use the application detail page to find the endpoint for an application and copy it for use in client applications.

Find an Application

  1. Go to the Applications list page. If you need help finding the list page, see Listing Applications.
  2. If needed, use the Application type filter to narrow the list.
  3. Select the application that you want to use.

How to Use

On the application detail page, copy the API endpoint and use it in a client application. Append the custom path that your container exposes to the endpoint.

To check the authentication setting, open the Configuration tab and review Authentication type under Authentication.

For applications that use No authentication, invoke the endpoint without obtaining a platform-issued access token or signing the invocation with OCI IAM. Supply any credentials required by authentication implemented in your application. See Using No Authentication.

For applications that use identity domain bearer token authentication, the endpoint includes hostedApplications. Clients send an OAuth access token as a bearer token with requests. See Invoking Applications.

https://inference.generativeai.<region>.oci.oraclecloud.com/20251112/hostedApplications/ocid1.generativeaihostedapplication.oc1.<region>.../actions/invoke/<custom_path>

For applications that use OCI IAM authentication, the endpoint includes hostedApplicationsIam. Clients sign requests according to OCI IAM request-signing requirements.

https://inference.generativeai.<region>.oci.oraclecloud.com/20251112/hostedApplicationsIam/ocid1.generativeaihostedapplicationiam.oc1.<region>.../actions/invoke/<custom_path>

For applications that use identity domain browser session authentication, browser users sign in through the associated identity domain when prompted. The hosted application service obtains an access token on their behalf and establishes a browser session that uses a session cookie. See Identity domain browser session.