LAYSO

English

简体中文

English

简体中文

Appearance

Configure Chatbox ​

Chatbox is a cross-platform AI client for Windows, macOS, Linux, iOS, and Android. Its custom model-provider feature can connect LAYSO AI through OpenAI, Responses, Anthropic, or Gemini-compatible modes.

One key for every platform model

One LAYSO AI API key can access every model available on the platform. Billing follows the selected model's current price. Every successful request has an itemized charge, while failed tasks are not charged.

Prerequisites ​

  1. Create and copy a key on the API Keys page.
  2. Choose a model on Models and pricing, then copy the exact model ID displayed there.
  3. Install the correct version for your device from the Chatbox website.

Do not guess model names

Use the model ID, context length, and capabilities shown on the Models and pricing page. Do not remove provider prefixes or copy arbitrary example model names.

Protocols and addresses ​

Chatbox lets a custom provider use different API modes. Match the host to the protocol supported by the target model:

Chatbox API modeAPI HostUse case
OpenAI API Compatiblehttps://api.layso.ai/v1Chat Completions, tool calls, and vision
OpenAI Responses API Compatiblehttps://api.layso.ai/v1Responses API models and new projects
Anthropic Claude API Compatiblehttps://api.layso.aiNative-compatible Anthropic Messages
Google Gemini API Compatiblehttps://api.layso.aiNative-compatible Gemini requests

Address rule

The two OpenAI modes use https://api.layso.ai/v1. Anthropic and Gemini modes use the gateway root https://api.layso.ai. Do not append another /v1, /messages, /v1beta, or a complete request path.

Desktop setup ​

Step 1: Open Settings ​

Launch Chatbox and select Settings in the lower-left sidebar.

Step 2: Add a model provider ​

Select Model Provider in the settings sidebar, then select + Add Provider at the bottom of the list.

Step 3: Select an API mode ​

Enter LAYSO AI as the name, then choose a protocol for the target model:

  • Use OpenAI API Compatible for typical chats.
  • Use OpenAI Responses API Compatible when the model and workflow require Responses.
  • Use Anthropic Claude API Compatible for the native Anthropic request format.
  • Use Google Gemini API Compatible for the native Gemini request format.

Select Add after choosing the protocol.

Step 4: Enter connection details ​

Fill in the fields for the selected API mode:

Chatbox fieldValue
NameLAYSO AI
API KeyThe complete key copied from the API Keys page
API HostThe matching address from the protocol table above

Select Fetch to load the model list. Paste the API key only into the key field, never into Name or Model.

Step 5: Enable a model ​

In the fetched list, select the + next to a model to add it to the enabled list.

If the list is empty or the target model is missing:

  1. Open Models and pricing.
  2. Copy the exact model ID.
  3. Return to Chatbox and add the model manually.
  4. Set the model type to Chat.
  5. Enable vision, reasoning, or tool-use capabilities only when the model page lists them.

Step 6: Check the connection ​

Select Check, then choose an enabled model for the test.

Save after Chatbox reports a successful connection. If the dialog checks text, images, and tool calls separately, only capabilities supported by the selected model need to pass.

Mobile setup ​

Chatbox for iOS and Android uses the same LAYSO AI addresses, although navigation differs from the desktop app.

Step 1: Open Settings and add a provider ​

Open the sidebar from the upper-left menu, select Settings, then select Add Model Provider.

Enter:

  • Name: LAYSO AI
  • API mode: choose from the protocol table above
  • API Key: copy it from the API Keys page
  • API Host: use the matching address from the protocol table

Step 2: Configure model parameters ​

After saving the provider:

  1. Copy the exact model ID from Models and pricing.
  2. Set the model type to Chat.
  3. Enable vision, reasoning, or tool-use only when the model supports it.
  4. Save the model.

Step 3: Test the connection ​

Select Test Model. Return to the home screen after it succeeds. If it fails, use the troubleshooting checklist below.

Start using Chatbox ​

  1. Close Settings and return to the Chatbox home screen.
  2. Open the model selector near the prompt box.
  3. Select the enabled model under LAYSO AI.
  4. Send a short message and confirm that a response returns.

Verification and billing ​

After the first successful chat, confirm that:

  1. The active Chatbox provider is LAYSO AI.
  2. The response model matches the selected exact model ID.
  3. The successful request has an itemized charge in Usage logs.
  4. A failed request did not create a charge.
  5. No complete API key appears in screenshots, logs, or exported settings.

Troubleshooting ​

Fetch returns an empty model list ​

  • Confirm that API Host matches the selected API mode.
  • Remove an unnecessary trailing slash and check for duplicated protocol paths.
  • Copy the API key again without spaces or line breaks.
  • If fetching still fails, add the exact model ID manually from Models and pricing.

Connection check fails ​

  1. Confirm that the current network can access https://api.layso.ai.
  2. Confirm that the API key is still active.
  3. Confirm that the model ID supports the selected API mode.
  4. Save, fully quit Chatbox, and reopen it.

401 or 403 ​

Copy the key again from the API Keys page. Do not use another platform's key or manually include the Bearer prefix in Chatbox's API Key field.

404 ​

This usually means that API mode and API Host do not match:

  • OpenAI and Responses: https://api.layso.ai/v1
  • Anthropic and Gemini: https://api.layso.ai

Do not enter a complete endpoint such as /chat/completions, /responses, /messages, or /v1beta/models in API Host.

Text works, but vision or tool-use checks fail ​

The model may not support that capability, or its capability toggle may be incorrect. Follow the capability information on Models and pricing.

Privacy and security ​

  • Never share a complete API key in screenshots, chats, logs, or support tickets.
  • Remove the custom provider and key after using a shared device.
  • If a key may be exposed, delete it on the API Keys page and create a replacement immediately.
  • Chatbox is a third-party client; refer to Chatbox's documentation for local storage, sync, and data-handling behavior.

Replacing the image placeholders ​

This page reserves image positions only. Put screenshots in docs/public/screenshots/chatbox/, then replace a placeholder with standard Markdown, for example:

md
![Chatbox LAYSO AI provider settings](/screenshots/chatbox/04-provider-fields.png)

Further reading ​

LAYSO AI API 文档

MIT 2026 © LAYSO AI