Getting started with the Inflection AI API

Inflection-3 comprises two models designed for distinct purposes:

Pi (3.0): the model powering our Pi experience, including a backstory, emotional intelligence, productivity, and safety. It excels in scenarios such as customer support chatbots. Set the config field in the API request body to "inflection_3_pi" to use this model.
Productivity (3.0): the model optimized for following instructions. It is better for tasks requiring JSON output or precise adherence to provided guidelines. Set the config field in the API request body to "inflection_3_productivity" to use this model.

Things to try

Pi has been trained to mirror your tone and style, if you use more emojis, so will Pi! Try experimenting with various prompts and conversation styles.

Pricing

Account setup and billing

To start generating API keys, all new users must provide valid credit card information and make an initial deposit of $100 to their account. This ensures a seamless onboarding experience and uninterrupted access to our services.

Model	Pricing for Input Tokens	Pricing for Output Tokens
Productivity Pi	$2.50 per 1M	$10 per 1M
Pi 3.0	$2.50 per 1M	$10 per 1M

Inflection uses the cl100k_base encoding from tiktoken for tokenization.

Context Window

Both models currently support a 8k context window.

Real-time usage tracking

After each API request, users can easily monitor their API usage through intuitive, real-time usage graphs. These tools provide transparency and control, allowing users to track their consumption and manage their balance effectively.

Customizable auto-reload

For added convenience, you can set a customizable account auto-reload threshold. If your balance falls below the designated threshold, the credit card on file will be automatically charged with an auto-reload amount of your choosing. Both the threshold and the top-up amounts are fully configurable to align with your needs, providing flexibility and peace of mind.

Authentication

To access and interact with the Inflection AI API, every request must include a valid API key. This key serves as a token that authenticates your organization or personal account with the API, ensuring secure and authorized usage. Below, we’ll walk through how to obtain your API key and demonstrate the process of including it in your requests.

Obtaining your API key

To begin using the Inflection AI API, you need to obtain an API key. Follow these steps to retrieve your key:

Go to 'API Keys' page: Once signed in and in the appropriate workspace, navigate to the API Keys page.
Create API Key: Click on 'Create API key' and type in a meaningful name for your key. Your key's name must be at least 3 characters long.
Try it out: Either try using the cUrl command provided in the confirmation pop-up or go to the Playground page and try the key out.

Reminder: to generate an API key, your workspace must have a payment method and added credits on the Billing page.

API key usage

Your API key is a long alphanumeric string that resembles the following example:

nfHB2f...IrQNMm4

This key must be included in the headers of all API requests to authenticate the client.

Including the API key in requests

For each request to the Inflection AI API, include the Authorization header with the value Bearer <YOUR_API_KEY>.

Here is an example request using cURL that includes the required header:

curl --location 'https://layercake.pubwestus3.inf7ks8.com/external/api/inference' \
    --header 'Authorization: Bearer <YOUR_API_KEY>' \
    --header 'Content-Type: application/json' \
    --data '{
        "context": [
            {
                "text": "Hi",
                "type": "Human"
            }
        ],
        "config": "inflection_3_pi"
    }'

The Authorization header is used to pass your API key.
The Bearer prefix is mandatory and must precede your API key.
The Content-Type header specifies that the request is in JSON format.
The --data flag includes the request payload with the input context and configuration.

For additional details on the structure of this request, see our API documentation.

Key management

Security: It is crucial to keep your API key secure and confidential. Avoid exposing it in publicly accessible codebases or client-side applications. If you believe your key has been compromised, you can delete the compromised key and generate a new one through the developer portal.

Handling authentication errors

In the event of an authentication failure, the API will return an appropriate error message. Below are the common authentication-related error codes:

401 Unauthorized: This error indicates that the API key is missing, invalid, or expired. Ensure that the Authorization header is properly configured with the correct API key.
403 Forbidden: This error occurs when the API key does not have the required permissions to access the requested resource.

Example of an authentication error response:

{
    "detail": "Forbidden"  
}

In such cases, double-check that the API key is valid and that it has the necessary permissions for the API resources you're accessing.

Workspaces

Inflection's developer portal supports a notion of workspaces to allow developers to collaborate by sharing keys and billing details among members of the workspace.

You can switch between your workspaces using the drop down on the left hand side and view members of your current workspace on the Workspace page. To navigate their page, first select Account in the top right and then Workspace on the left hand side.

Creation

By default, whenver a user first logs in they are placed in a personal workspace to which only they belong. If you wish to invite users to this workspace, you can first change the name of the workspace by selecting Rename workspace on the Workspace page.

To create a new workspace:

Go to the Workspace page.
Select the Create workspace button in the top right.
Don't forget to invite other users to your new workspace.

User management

Currently inviting and removing users is only availble to workspace admins.

To invite users to a workspace, navigate to the Workspace page and select the Invite user button. Then, enter the email for the user you wish to invite. The user you are inviting must already have an account on the developer portal.

After a user is invited, the next time they log-in, they will see any workspace invitations at the top of the Playground page where they can select either Accept or Decline.

To remove a user from an organization, navigate to the Workspace page and click on the trash icon associated with the user you wish to remove.

Prompt examples

Building on your understanding of the Inflection AI API and initial experiments, this section provides comprehensive prompt examples designed to demonstrate the versatility and depth of our models. These examples illustrate various use cases, ranging from conversational intelligence to advanced problem-solving, enabling you to harness the full potential of the Pi.

We encourage you to adapt and refine these examples to suit your specific requirements, driving deeper insights and innovation as you engage with our AI platform.