API Group
Learn how to use the Perplexity API Portal to manage access, usage, billing, and team collaboration.
This guide walks through how to set up API organizations.
If you are new to the API Portal, start by creating an API Group to organize your users and resources. Please refer to the previous guide for this.
Accessing the API Portal
Once signed in, navigate to the left-hand sidebar and expand the API section to access your API group and related settings.
Creating and Managing an API Group
To set up your organization:
- Click API Group in the left sidebar.
- Fill out your organization’s name, address, and tax details.
Your organization name and address will appear on invoices and help us support you better.
Fields include:
- Organization name and description
- Address (Line 1, Line 2, City, State, Zip, Country)
- Tax ID
Adding and Managing Members
Admins can invite team members to the organization with specific roles: Admin or Member.
To Add a Member:
-
Click + Add Member.
-
Enter the user’s email address and click Invite.
-
The invited user will receive an email with a link to join your group.
Filtering Members by Role
Use the dropdown to filter your list of team members by role.
Roles
- Admin: Full access to invite/remove members, manage billing, and view usage data.
- Member: Can view usage and account limits but cannot modify settings.
Only Admins can make changes to billing and member permissions.
Billing and Payment Methods
Admins can manage billing under the API Billing tab. This includes:
- Adding or updating credit card information
- Enabling or disabling auto-reload
- Viewing invoice history and usage tier
- Register your credit card to get started
This step will not charge your credit card. It just stores payment information for later API usage.
Viewing Usage Metrics
All members can view API usage by selecting Usage Metrics from the sidebar.
Features include:
- Total API call trends over time
- Breakdown by API model and key
- Optional date range filters
Usage metrics help you monitor API activity and optimize for cost or performance.
Viewing Rate Limits and Tiers
You can view your API rate limits and organization tier under the Usage Tier section in the billing view.
Details shown:
- Current rate limits per API
- Tier level
Managing API Keys
The API key is a long-lived access token that can be used until it is manually refreshed or deleted.
- Every API call needs a valid API key. You must send the API key as a bearer token in the Authorization header with each API request.
Admins can generate and revoke API keys from the API Keys tab.
To create a key:
- Click + Create Key to generate a new API key.
API keys are sensitive credentials. Never expose them in client-side code or share them in public repositories.
If you run out of credits, your API keys will be blocked until you add to your credit balance. You can avoid this by configuring “Automatic Top Up”, which refreshes your balance whenever you drop below $2.