Manage Console

XAI Manage is a graphical console for end users or authorized administrators, providing account status, credits, usage, billing, logs, and news viewing, along with common self-service capabilities (such as key rotation and sub-account management).

—

Feature Overview

The XAI Manage console includes the following core functional modules:

Usage Statistics (Dashboard) - View today's real-time usage, specific dates, and time range usage analysis
Account Query - Batch query sub-account information
AI API Documentation - View supported AI service providers and SDK examples
Create Sub-Account - Create new sub-accounts under your account
Account Top-up - Top up or deduct credits for sub-accounts
View Sub-Accounts - View all sub-account lists
Update Sub-Account - Modify sub-account configuration and limits
Delete Sub-Account - Delete sub-accounts and refund balance
Operation Logs - View account operation records
System Configuration - Jump to Admin console (owner only)

—

Access Control

All Users Can Access: Any user with a valid API Key can log in to Manage console
Local Key Storage: API Key is only stored in browser localStorage, never uploaded to server
Session Cache: User info cached in sessionStorage (24 hours), requires re-fetch after closing tab
News Cache: News data cached locally for 1 hour, supports "don't show again today" feature

Common Task Guide

View today/history usage → "Usage Statistics" → see Manage API: Usage Billing
Batch query sub-accounts → "Account Query" → see Manage API: Query Sub-Accounts
Create sub-account → "Create Sub-Account" → see Manage API: Create Sub-Account
Top-up/refund → "Account Top-up" → see Manage API: Update Sub-Account
Constrain access scope → "Update Sub-Account" → see Manage API: Update Sub-Account
Set Model Limits → "Update Sub-Account" → see Manage API: Update Sub-Account
View operation logs → "Operation Logs" → see Manage API: Operation Logs

Feature–Endpoint–Permission Matrix

Complete API endpoints and usage can be found in Manage API Reference

Feature	API Documentation	Permission
Usage dashboard	Manage API: Dashboard Query	Any valid user
Sub-account list/query	Manage API: Query Sub-Accounts	Parent/ancestor only
Create sub-account	Manage API: Create Sub-Account	Parent/owner only (with sufficient balance/limits)
Update sub-account	Manage API: Update Sub-Account	Parent/owner only
Delete sub-account	Manage API: Delete Sub-Account	Parent/owner only
Operation logs	Manage API: Operation Logs	Any valid user (typically view own scope only)
News	Manage API: News Notifications	Any valid user

Terminology: Level, Model Mapper, Level Mapper, Resources (allowlist), Model Limits — see "Terminology".

Feature Details

1. Usage Statistics Tab

Real-time viewing and analysis of account usage data with multiple time dimensions and metric switching.

Features:

Today's Real-time Usage - Display today's requests, tokens, and cost
Specific Date Query - Select a specific date to view that day's usage
Time Range Query - Select start and end dates to view interval usage
Metric Switching - Switch between cost, requests, and tokens
Chart Display - Usage trend charts (if multiple days of data)
Model Usage Details - View detailed usage distribution by model

Operation Steps:

Default displays today's real-time usage
Select "Specific Date" and choose a date to view single-day usage
Select "Time Range" and set start/end dates to view interval usage
Use metric switch buttons to switch between different dimensions

Related API: See Manage API: Usage Billing

2. Account Query Tab

Batch query detailed information for sub-accounts.

Features:

Batch Query - Input multiple account identifiers, separated by commas or newlines
Support Multiple Identifiers - ID, Name, Email, DNA path, etc.
Detailed Info Display - Show account balance, limits, usage, and complete information
Result Export - Copy query results

Identifier Types:

User ID: 42
Username: prod-account
Email: [email protected]
DNA path: .1.42.
Level filter: L2 (all level 2 users)

Related API: See Manage API: Query Sub-Accounts

3. AI API Documentation Tab

Same as Admin console, displays supported AI service providers and SDK example code.

Features:

Model list link
Supported AI service providers display
OpenAI and Claude SDK example code
One-click copy functionality

4. Create Sub-Account Tab

Create new sub-accounts under your account.

Features:

Complete Creation Form - Include all required and optional fields
Real-time Validation - Real-time validation of field formats and values
Flexible Configuration - Support setting limits, rate limits, allowlists, etc.

Form Fields:

Basic Info (Required):

Name - Account name (4-63 characters, at least 1 letter)
Email - Email address
CreditGranted - Initial top-up amount (minimum $2)

Optional Config:

Alias - Display name
BillingEmail - Billing email
Rates - Rate multiplier (must be ≥ parent rate)
Days - Balance validity period in days

Limit Settings:

HardLimit - Monthly hard limit
SoftLimit - Monthly soft limit (email alert when reached)
AutoQuota - Auto quota

Rate Limits:

RPM/RPH/RPD - Requests per minute/hour/day limits
TPM/TPH/TPD - Tokens per minute/hour/day limits

Rate Limit Semantics (Important):

RPM/RPH and TPM/TPH are short-window limits. After they are hit, the system enters an independent cooldown; repeated retries without backoff can refresh that cooldown.
RPD/TPD are natural-day quotas based on the server-side business date, not rolling 24-hour windows.
Cooldown after RPD/TPD only lasts until the end of the current day. Retries do not extend recovery past the next day boundary.
TPD is accrued after successful token usage. If one successful request fills or exceeds the day cap, 429 TPD usually begins on the next request.

Access Control:

AllowIPs - IP allowlist (comma-separated)
AllowModels - Model allowlist (supports wildcards like gpt-4*)
Resources - API endpoint allowlist

Model Limits:

Set independent rate limits for specific models (JSON format)
Model aliases, model mappings, and upstream snapshot names are merged into the effective model for accounting, so one logical model does not get split across multiple counters

Related API: See Manage API: Create Sub-Account

5. Account Top-up Tab

Top up or deduct credits for sub-accounts.

Features:

Account Selection - Input user ID, Name, or Email
Top-up/Deduction - Positive for top-up, negative for deduction
Custom Validity - Set balance validity period in days
Batch Operations - Support simultaneous operations for multiple accounts

Operation Instructions:

Input target account identifier
Input amount:
- Positive (e.g., 100) means top up $100
- Negative (e.g., -50) means deduct $50
Optional: Set validity period days (default 180 days)
Submit operation

Related API: See Manage API: Update Sub-Account

6. View Sub-Accounts Tab

View list and detailed information of all direct sub-accounts.

Features:

Account List - Display all sub-accounts
Key Information - ID, Name, Email, Balance, Status
Filter and Search - Filter accounts by conditions
Quick Actions - Click account to view details or perform actions

Related API: See Manage API: Query Sub-Accounts

7. Update Sub-Account Tab

Modify existing sub-account configuration and limits.

Features:

Complete Update Form - Similar to creation form but supports partial updates
Status Management - Enable/disable accounts
Config Modification - Modify limits, rates, allowlists, etc.
Model Limits - Update model-level rate limits

Updatable Fields:

All optional fields from creation can be updated, plus:

Status - Enable/disable account (true/false)
CreditGranted - Top-up/deduction
Days - Balance validity
Incremental modification of limits, rates, allowlists

Special Operations:

Reset allowlist: AllowModels: "*"
Remove from allowlist: AllowModels: "-gpt-3.5-turbo"

Related API: See Manage API: Update Sub-Account

8. Delete Sub-Account Tab

Delete sub-accounts and refund remaining balance to parent account.

Features:

Account Selection - Input account identifier to delete
Balance Refund - Automatically refund remaining balance to parent account
Transaction Fee - Deduct $0.2 handling fee
Confirmation Mechanism - Prevent accidental deletion

Important Notes:

Remaining balance automatically refunded to parent account
Deduct $0.2 transaction handling fee
Refunded balance default validity 180 days
Cannot be recovered after deletion

Related API: See Manage API: Delete Sub-Account

9. Operation Logs Tab

View current account's operation logs.

Features:

Log List - Display time, operation, target, details, IP
Paginated Browsing - Support paginated viewing of historical logs
Filter Functionality - Filter by operation type, status, etc.

Related API: See Manage API: Operation Logs

10. System Configuration Entry

Owners can see "Configuration Management" link, clicking jumps to Admin console.

—

Manage console top displays system news and user notifications.

Features:

Priority Display - System news > User news > DNA news
Don't Show Today - Close and won't show again today
Auto Carousel - Multiple news items auto-rotate
Local Cache - News cached for 1 hour, reducing requests

Related API: See Manage API: News Notifications

—

Use Cases

Use Case 1: View Today's Usage

After login, default displays "Usage Statistics" tab
Page automatically shows today's real-time usage:
- Today's requests
- Today's tokens
- Today's cost
View detailed model usage distribution

Use Case 2: Create Development Environment Sub-Account

Go to "Create Sub-Account" tab
Fill in basic info:
- Name: dev-env-001
- Email: [email protected]
- CreditGranted: 10 (top up $10)
Set limits:
- HardLimit: 50 (max $50 monthly spend)
- SoftLimit: 40 (email alert at $40)
- RPM: 30 (max 30 requests per minute)
Set allowlist:
- AllowModels: gpt-5-nano claude-3-haiku* (only allow these models)
Submit creation
System returns new account's API Key

Use Case 3: Top Up Sub-Account

Go to "Account Top-up" tab
Input sub-account name: dev-env-001
Input top-up amount: 50
Set validity: 30 days
Submit operation
System confirms successful top-up

Use Case 4: Update Sub-Account Limits

Go to "Update Sub-Account" tab
Input account identifier: dev-env-001
Modify config:
- RPM: 60 (increase rate limit)
- AllowModels: gpt-4* claude-* (expand model allowlist)
Submit update
System confirms successful update

Use Case 5: Analyze Usage Trends

Go to "Usage Statistics" tab
Select "Time Range"
Set date range: 2025-01-01 to 2025-01-31
Switch metrics to view:
- Cost trends
- Request trends
- Token usage trends
View usage distribution by model

—

Best Practices

Account Management

Tiered Management - Create independent accounts for different environments (dev/test/prod)
Reasonable Limits - Set SoftLimit and HardLimit to avoid unexpected overspending
Model Allowlist - Restrict sub-accounts to specific models only
Regular Audit - Regularly review sub-account lists and usage

Top-up Management

Top Up As Needed - Don't top up too much at once
Set Validity - Set shorter validity for test accounts
Retain Balance - Deduct before deleting accounts to reclaim balance

Usage Monitoring

Daily Check - Check today's usage to avoid anomalies
Trend Analysis - Regularly analyze usage trends to optimize costs
Model Optimization - Choose appropriate models based on usage data

—

FAQ

Q: Why can't I see "System Configuration" entry?

A: "System Configuration" is only available to XAI Control owner accounts. Here, an Owner means a first-level account created by self-signup on xaicontrol.com; sub-accounts are accounts created and distributed by the owner inside the system. Owners can configure and manage their own third-party AI API Keys in the Admin console (a.xaicontrol.com) and distribute resources to sub-accounts. Sub-accounts use the Manage console (m.xaicontrol.com) for daily operations, so they do not see the "System Configuration" entry.

Q: What's the minimum top-up amount when creating sub-accounts?

A: Minimum top-up amount is $2 (CreditGranted ≥ 2).

Q: How to restrict sub-accounts to specific models only?

A: When creating or updating sub-accounts, set the AllowModels field. Supports wildcards like gpt-4* claude-3-haiku*.

Q: Can sub-account rates be lower than parent account?

A: No. Sub-account Rates must be greater than or equal to parent account rates.

Q: How is balance handled after deleting sub-accounts?

A: Remaining balance automatically refunded to parent account, minus $0.2 handling fee, with 180-day validity.

Q: Why am I being charged when querying usage?

A: Query spans >30 days charge $0.01, >365 days charge $0.05 and truncate to one year.

Q: How to batch query multiple sub-accounts?

A: In "Account Query" tab input multiple identifiers, separated by commas or newlines, like:

dev-env-001
prod-account
[email protected]
42

—

Manage API Reference - Complete Manage Console API documentation
Admin API Reference - System configuration and Provider management API
Admin Console - Configuration management console
Quick Start - Basic getting started guide

Manage Console

Feature Overview

Access Control

Common Task Guide

Feature–Endpoint–Permission Matrix

Feature Details

1. Usage Statistics Tab

2. Account Query Tab

3. AI API Documentation Tab

4. Create Sub-Account Tab

5. Account Top-up Tab

6. View Sub-Accounts Tab

7. Update Sub-Account Tab

8. Delete Sub-Account Tab

9. Operation Logs Tab

10. System Configuration Entry

News Banner Feature

Use Cases

Use Case 1: View Today's Usage

Use Case 2: Create Development Environment Sub-Account

Use Case 3: Top Up Sub-Account

Use Case 4: Update Sub-Account Limits

Use Case 5: Analyze Usage Trends

Best Practices

Account Management

Top-up Management

Usage Monitoring

FAQ

Related Documentation