Skip to main content
Version: v1.1.x

Create a Client

This guide explains how a platform administrator creates a client on a PaletteAI Inference Launchpad appliance. A client is a named team, business unit, or workload, represented by one or more API tokens. To understand what a client is and how clients, API tokens, and quotas relate, refer to Clients and Quotas.

To generate an API token by itself, without stepping through the full client setup, refer to Generate an API Token.

Prerequisites​

  • A running PaletteAI Inference Launchpad appliance, with the console reachable.
  • Console access with permission to manage clients. Managing clients can require operator access.

Create a Client​

Create a client through the Add client wizard. The wizard names the client, optionally sets a quota, optionally grants model access, and optionally issues the client's first API token.

  1. From the left main menu, select Access & Policy. The Clients & API tokens page opens.

  2. Select Add client. The Add client wizard opens on the Overview step.

  3. On the Overview step, enter a Client name, and then select Next step. The appliance assigns the client an immutable identifier and registers it as active.

  4. (Optional) On the Quotas step, add usage limits for the client, and then select Next step. For details, refer to Set and Manage Client Quotas.

  5. (Optional) On the Egress step, select Enable egress to let the client reach external models, including built-in frontier providers and registered external inference endpoints, and then select Next step. External access is denied by default. To add a provider key or authorize a registered endpoint, and to set a daily spend cap, refer to Manage a Client's Model Access. To register an endpoint first, refer to Register an External Inference Endpoint.

  6. (Optional) On the Routing step, leave the Tier map unchanged to route the client with the appliance's default model routing, or edit the Tier map to route the client's model aliases to specific models. Then select Next step. For details, refer to Manage a Client's Model Access.

  7. On the API tokens step, select Add API Token. In the Add API token dialog, optionally enter a Label, choose an Expires date, and then select Add Token. Expires is required, and the console accepts a date up to 366 days ahead. The token stops working at the end of the day you choose.

  8. Select Create client.

  9. When the console reveals the token, select Copy. The token begins with lpai_. To read the connection steps for a coding assistant without leaving the dialog, select Connect Agent.

warning

The console shows the token only once and stores only a hash of it. Copy it now. If you lose it, revoke the token and create a new one.

A client can hold more than one API token. To add another token to a client later, refer to Generate an API Token.

Verify the Client​

Confirm that the appliance registered the client and its API token.

  1. From the left main menu, select Access & Policy.

  2. On the Clients & API tokens page, confirm the new client appears in the list under the name you gave it.

  3. Select the client to open its detail panel, and then select the API tokens section.

  4. Confirm the token you added appears with a state of active.

The client is ready to use once its token is active. To confirm the token works from end to end, connect a coding assistant to the appliance with it, as described in Use Claude Code.

Next Steps​

After you create a client, configure how much it can consume and which models it can reach.