Getting Started with XAI Control (Cloud)

This document will guide you step-by-step through registering for the XAI Control cloud service, obtaining an API Key, and managing sub-accounts with fine-grained controls, helping you get started quickly.

1. Register an Account

1. Open your browser and visit a.xaicontrol.com.
2. Click "Register Now", enter your email address, and click "Send Verification Code".
3. Log in to your email and find the email with the subject "Your XAI Verification Code" (Note: The email might be mistakenly marked as spam, so please check your spam folder as well).
4. Click the "Click to Activate Account" button in the email. You will be redirected back to XAI Control with a success message.
5. After successful activation, the system will automatically send another email to the same address with the subject "Welcome to XAI - Your Account is Ready!", which contains your exclusive XAI API Key.

2. Add a Provider Key

1. Log in to a.xaicontrol.com.
2. Go to "Providers" → "Add Provider Key".
3. Fill in the following:
   • Name (Optional): A custom name for easy management.
   • Level: A positive integer for model grouping and categorization.
   • Provider: The API Base URL of the model provider, for example:
     • OpenAI: https://api.openai.com
     • Anthropic: https://api.anthropic.com
     • DeepSeek: https://api.deepseek.com
     • Google Gemini: https://generativelanguage.googleapis.com
   • SecretKey: The API Key from the corresponding provider, typically starting with sk- (or AIzaSy for Google Gemini).
4. Click "Add Provider Key". The system will encrypt and store this key in your dedicated data space.

   

3. Quick Test

After completing the steps above, you can use your XAI API Key to call the integrated AI services.

Important Prerequisite

The following examples show how to call OpenAI and Anthropic models respectively. Please ensure that you have added the corresponding Provider Key for the model provider you want to test (e.g., OpenAI, Anthropic) in Step 2. If you have only added the OpenAI key, the Anthropic example will not work.

Calling OpenAI Models

export XAI_API_KEY="Your-XAI-API-Key"

curl https://api.xaicontrol.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
      "model": "gpt-4o-mini",
      "messages": [{"role": "user", "content": "Hello, world"}]
    }'

Calling Anthropic Models

export XAI_API_KEY="Your-XAI-API-Key"

curl https://api.xaicontrol.com/v1/messages \
  -H "x-api-key: $XAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
      "model": "claude-3-7-sonnet-latest",
      "max_tokens": 1024,
      "messages": [{"role": "user", "content": "Hello, world"}]
    }'

4. Sub-Account Management (Fine-Grained Permissions and Quota Control)

XAI Control supports a multi-level sub-account system, making it easy for teams or clients to isolate resources and manage billing independently.

Please note that XAI Control has two management portals:

1. Configuration Portal: a.xaicontrol.com (Registered users are primary accounts, used for configuring third-party AI Provider Key resources).
2. Account Management Portal: m.xaicontrol.com (Primary accounts manage sub-accounts and quotas here; sub-accounts view their own usage here).

4.1 Create a Sub-Account

1. The primary account logs in to m.xaicontrol.com and navigates to the "Create Sub-Account" page.
2. Fill in:
   • Sub-account username
   • Sub-account email (The system will send the sub-account's XAI API Key to this email)
   • Initial quota
3. Click "Create Sub-Account"

4.2 Configure Sub-Account Permissions and Quota

Click "Update Sub-Account" to configure fine-grained controls:

4.3 Sub-Account Login

Sub-accounts log in to m.xaicontrol.com using their own XAI API Key and can only see:

• Their own usage and remaining quota.
• They cannot view or modify the primary account's AI Provider Keys.

5. Why Choose XAI?