> For the complete documentation index, see [llms.txt](https://docs.world3.ai/world3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.world3.ai/world3/how-to-guides/routerlink/tutorials/how-to-integrate-routerlink-in-chatboxai.md).

# How to integrate RouterLink in ChatboxAI

{% hint style="info" %}
This documentation is provided for informational purposes only and demonstrates how to configure and use our API with third-party AI chat interfaces. Any third-party software, websites, or services mentioned are not operated, controlled, or endorsed by us.
{% endhint %}

## Overview

This tutorial guides you through integrating **RouterLink**—WORLD3's decentralized AI model routing infrastructure—with **ChatboxAI**, a versatile AI client application available across multiple platforms.

### Purpose

RouterLink provides a unified API endpoint that routes requests to multiple AI model providers through a decentralized network. By integrating RouterLink with ChatboxAI, you gain access to a diverse range of large language models (LLMs) without managing multiple API keys or provider-specific configurations.

### What You Will Learn

By completing this tutorial, you will:

* **Configure ChatboxAI** to connect with RouterLink's API endpoint
* **Authenticate** using your RouterLink API credentials
* **Add and manage AI models** available through the RouterLink network
* **Execute inference requests** through ChatboxAI's conversational interface

### Prerequisites

Before proceeding, ensure you have:

* A RouterLink API key (obtain one from the [Quick Start Guide](https://docs.world3.ai/world3/how-to-guides/routerlink/quick-start-guide))
* A web browser with internet access
* Basic familiarity with API configuration concepts

***

## Introduction to ChatboxAI

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FxK7c3i6Tl8LjVUih2uOm%2Fimage.png?alt=media&amp;token=a21853b4-8fcd-402a-8f3f-393567804dd6" alt=""><figcaption></figcaption></figure>

**ChatboxAI** is an AI client application and smart assistant that provides a unified interface for interacting with cutting-edge AI models and APIs. It offers cross-platform availability on Windows, macOS, Android, iOS, Web, and Linux.

Key features include:

* Multi-provider model support with custom API configurations
* Cross-platform availability (desktop, mobile, and web)
* Clean and intuitive user interface
* Support for multiple concurrent model configurations

***

### Step 1: Access ChatboxAI

Navigate to <https://web.chatboxai.app/> to access the web version of ChatboxAI.

***

### Step 2: Configure a New Provider

1. Click **"Settings"** located in the bottom-left corner of the interface.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FDN3o4Un6OvIqAyFkVbkf%2Fimage.png?alt=media&amp;token=a5597309-4dff-4819-8ecb-febc8ff242f8" alt=""><figcaption></figcaption></figure>

\
2\. Click the **"+ Add"** button in the bottom-left area to add a new provider.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FHeymXxm79hAu7YZU743c%2Fimage.png?alt=media&amp;token=8e7605b8-5788-46c2-b93a-6e43b76d1f53" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FJlgZWtPxFmb1NlSkgadJ%2Fimage.png?alt=media&amp;token=92315d89-76be-403a-856a-ea772bfb8704" alt=""><figcaption></figcaption></figure>

3. Configure the provider with the following parameters:

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FrCkq6BU3olH6hVFatv1U%2Fimage.png?alt=media&amp;token=238de39c-d464-406f-897e-5a0d5c84a01c" alt=""><figcaption></figcaption></figure>

#### API Configuration Parameters

| Parameter    | Value                                                                                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **Name**     | A descriptive name (e.g., "RouterLink")                                                                                        |
| **API Mode** | Select the appropriate API mode                                                                                                |
| **API Key**  | Your RouterLink API key from the [Quick Start Guide](https://docs.world3.ai/world3/how-to-guides/routerlink/quick-start-guide) |

***

### Step 3: Retrieve Model Configuration from RouterLink

For this tutorial, we will configure **Claude Opus 4.5** model via RouterLink.

1. Visit the RouterLink model page at [Claude Opus 4.5](https://world3.ai/routerlink/Claude%20Opus%204.5) to access the integration details.
2. Select **"OpenAI"** as the integration format.
3. The following configuration details will be displayed:

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FYaqxs4lWpwmLrFB8gXDQ%2Fimage.png?alt=media&amp;token=44f51040-74a0-4f70-8289-1dfd629fabcb" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FKDO4GG6YfnNgDXO5GI74%2Fimage.png?alt=media&amp;token=1d57e588-12d0-42d2-be10-73be3fb0d467" alt=""><figcaption></figcaption></figure>

4. Copy the **Endpoint** value and paste it into the **API Host** field in ChatboxAI.

***

### Step 4: Add the Model <a href="#step-4-add-the-model" id="step-4-add-the-model"></a>

1. Click the **"+ New"** button to add a new model.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FRDXqLjhbTWzWDCAe6QCl%2Fimage.png?alt=media&amp;token=f56efb65-0bb1-452b-a16d-9fed2d040245" alt=""><figcaption></figcaption></figure>

2. Copy the model identifier from the RouterLink website and paste it into the model field:

```
world3-router-north-america/anthropic/claude-opus-4.5
```

3. Click the **"Test Model"** button to verify the connection. Upon successful validation, "Test successful" will be displayed in green.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FzmWs4loD72oSgYnKpNhB%2Fimage.png?alt=media&amp;token=f31ec2a5-9954-46f2-b2a2-43dda2f8c393" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2Fqm8RA31mp7v8pk844vvg%2Fimage.png?alt=media&amp;token=c664c7df-1b5a-4bd2-8d2f-229cba70aeae" alt=""><figcaption></figcaption></figure>

4. After clicking the **"Save"** button, the model will be registered in your provider configuration.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FbQ7yetVG3ESUTE9q6b44%2Fimage.png?alt=media&amp;token=082e4819-753d-4da3-820b-db7cdcb8a7ff" alt=""><figcaption></figcaption></figure>

5. Click the blue **"Check"** button to complete the configuration verification. All connections should display "successful" status.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FZF6qveYvSls2WnFKqpmc%2Fimage.png?alt=media&amp;token=355a72d6-a081-418c-b51a-be8b8eb4a6f6" alt=""><figcaption></figcaption></figure>

***

### Step 5: Initiate a Conversation <a href="#step-5-initiate-a-conversation" id="step-5-initiate-a-conversation"></a>

1. Click **"Select Model"** in the bottom-right corner and choose the RouterLink model you just configured.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FePHbpbd2ZgBc0ePPhL7C%2Fimage.png?alt=media&amp;token=3586bb80-b7f4-4783-a016-ce4d93478221" alt=""><figcaption></figcaption></figure>

2. Enter your desired prompt to confirm the integration is functioning correctly.

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FGsfNhYTEncBDMoIxdb9e%2Fimage.png?alt=media&amp;token=28f4ee78-0f15-48f4-a000-fbc7f1e9e188" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2F1poM7QLJ3adOQY3Uwcv5%2Fimage.png?alt=media&amp;token=4333f358-c51b-46a5-af75-4207ebc6d132" alt=""><figcaption></figcaption></figure>

3. If you are using the free daily WORLD3 credits, please set the max tokens to ensure the service works properly (for example, set it to 4096).

<figure><img src="https://1299308320-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz14Y82ikqf3KozqsiU9D%2Fuploads%2FNDPLheUgqc8RucCIeShi%2Fimage.png?alt=media&amp;token=de60a842-a977-465a-bd12-37a4d88ac4f8" alt=""><figcaption></figcaption></figure>

***

## Summary <a href="#summary" id="summary"></a>

You have successfully integrated RouterLink with ChatboxAI. You can now:

* Send prompts to various AI models through RouterLink's decentralized routing network
* Switch between different models available on the RouterLink platform
* Leverage ChatboxAI's interface features while utilizing RouterLink's infrastructure

For advanced configuration options, model availability, and API documentation, visit the [RouterLink Documentation](https://world3.ai/new-agent/router-link).

***

## Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

|                           |                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------- |
| **Authentication failed** | Verify your API key is correctly copied without leading/trailing spaces         |
| **Model not responding**  | Confirm the model ID matches the exact format from the RouterLink documentation |
| **Connection timeout**    | Check your network connectivity and ensure the API Host URL is correct          |
| **Test model fails**      | Verify the endpoint and API key are properly configured                         |

For additional support, please open a ticket on [Discord](https://discord.gg/world3).

## Links <a href="#links" id="links"></a>

* Website: [https://routerlink.world3.ai](https://routerlink.world3.ai/)​
* Litepaper: <https://docs.world3.ai/world3/routerlink-litepaper>​
* Genesis Program (Alpha Phase): <https://routerlink.world3.ai/?tab=alphaprogram>​
* Twitter: [@world3\_ai](https://twitter.com/world3_ai)​
* Discord: [discord.gg/world3](https://discord.gg/world3)
