Skip to main content
Playground lets you try a project before integrating an application. Each model round uses the selected Aixy API key’s project, model access, guardrails, and budgets, so you can verify the same configuration your client will use.

Start a conversation

  1. Select the project and open Playground.
  2. Choose a model from the picker.
  3. Open Request settings and select one of your project API keys.
  4. Choose Protocol / endpoint for Chat Completions, Responses, or Messages.
  5. Send a short message and inspect the streamed reply and response metrics.
Create a key from API keys if the project has none. The dashboard uses the key’s identity without displaying its saved secret. In Request settings, adjust Maximum output tokens from 1 to 131,072; the default is 1,024. The maximum applies to each model response, including each tool round, and includes internal reasoning when the model counts it toward completion. The selected model’s supported limits still apply. Application requests choose their own supported output bound. When a provider reports that a response stopped at its output-token limit, Playground keeps the partial text and available usage and displays Response reached its output-token limit. Increase the maximum for a longer response. In a tool conversation, start a new conversation before continuing: incomplete tool calls are never executed or reused as native history.

Check policies and costs

With a hard budget, Playground checks price coverage before the model request. That check sends no prompt and reserves no spend. A notice identifies incomplete pricing; use Recheck prices after an administrator has completed the pricing. Normal budget admission still runs when you send the message. Inspect the request ID and open Activity to see the provider error, route attempts, token usage, and available cost evidence. An error on the first model round preserves your draft so you can correct it and retry deliberately.

Reproduce a text request

Use Get code to copy the configured text request, including its selected token maximum, then supply your key from a protected local environment. This is useful when moving from a successful dashboard test to a backend or when comparing client behavior. See the quickstart for runnable examples.

Add tools and manage conversation state

Choose Select tools to use your connected accounts. Playground searches for authorized actions as needed and asks you to approve each external action. Follow Use tools in Playground for setup and execution behavior. New conversation clears the current history. Changing model, key, protocol, or selected tools also starts a new conversation. Stop cancels the current turn. Conversation state lives in the current page and is cleared on navigation or reload; explicitly enabled Activity capture follows its separate retention policy.